From f2b9bf6b4a287ccc71f2ee127c743d091a5102e9 Mon Sep 17 00:00:00 2001 From: Primetra Date: Tue, 27 Oct 2026 08:00:00 +0000 Subject: [PATCH] Primetra fix #1: Make docs.relaykit.example/quickstart worth citing (instructions) SAMPLE: this is an illustration from a fictional company. It will not apply to your repository. Adds PRIMETRA_FIXES.md: the exact text and the steps for a fix that are not a single file change. - Fix #1: Make docs.relaykit.example/quickstart worth citing (re-check on 2026-11-24) --- PRIMETRA_FIXES.md | 43 ++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+), 0 deletions(-) diff --git a/PRIMETRA_FIXES.md b/PRIMETRA_FIXES.md new file mode 100644 --- /dev/null +++ b/PRIMETRA_FIXES.md @@ -0,0 +1,43 @@ +# Primetra fixes to apply by hand + +> SAMPLE: this is an illustration from a fictional company. It will not apply to your repository. + +Relaykit: 1 fix that are not a single file change. Each has the exact text to use and where it goes. + +## Fix 1: Make docs.relaykit.example/quickstart worth citing + +_SAMPLE: this is an illustration from a fictional company. It will not apply to your repository._ + +Claude, Gemini and Grok read docs.relaykit.example/quickstart in 9 of 360 answers and cited courierly.example, devtoolsdigest.example and docs.python.org instead. A page that answers the buyer question in its first lines, with specifics and a clear date, gets cited more. + +Steps: + +1. Open docs.relaykit.example/quickstart. Claude, Gemini and Grok read it and still cited courierly.example, devtoolsdigest.example and docs.python.org for the same questions. +2. Add one heading per question and answer it in the first two sentences under it, starting with: "Which email API has the simplest developer experience?"; "How do I verify a sending domain with SPF, DKIM and DMARC?"; "Best email API with a generous free tier for side projects". +3. Under each answer put the specifics a buyer checks (limits, prices, versions, one example request) in plain text, and show a last-updated date on the page. +4. Serve the same page as markdown (docs.relaykit.example/quickstart.md, or on Accept: text/markdown) so coding agents get clean text. +5. Re-check in 28 days: we compare how many answers read this page and still cite someone else. + +Change (`https://docs.relaykit.example/quickstart`): + +```md +## Which email API has the simplest developer experience? + +A transactional email API for developers. +``` + +Add this block near the top of /quickstart, under the page's main heading. The sentences are copied from your own pages. Your pages never mention: has, simplest, experience. Check every claim, and keep the question as the heading. + +_Why this is not a patch file: the page's file in your repository is not known to Primetra yet._ + +Evidence: + +- Page: docs.relaykit.example/quickstart +- Claude read your pages but cited someone else: 10 of 120 answers +- Gemini read your pages but cited someone else: 13 of 120 answers +- Grok read your pages but cited someone else: 11 of 120 answers +- Cited instead: courierly.example, devtoolsdigest.example and docs.python.org +- Example question: Which email API has the simplest developer experience? +- Example question: How do I verify a sending domain with SPF, DKIM and DMARC? + +Primetra re-checks this on 2026-11-24 (UTC). -- primetra-patch-bundle 1