What ChatGPT actually cites when you ask about developer tools

We ran 40 developer-tool prompts through ChatGPT for eight weeks and logged every source it named. The pattern surprised us.

Ask ChatGPT which vector database to use and it will name one, cite a source, and move on to the next sentence like the question was never in dispute. Which source it names, and why that one and not another, turns out to be more predictable than it looks — and considerably more useful to know than most of the SEO advice written for a search engine that isn't reading the question the same way anymore.

We tracked 40 prompts across four categories of developer tools — vector databases, CI platforms, observability, and authentication — for eight weeks, running each one five times a day against ChatGPT at default settings, with no memory and no custom instructions. We logged the brand cited, the exact URL attributed, and the precise wording of the prompt, because small rewordings changed the answer more often than we expected going in.

What we tracked, and why so few prompts

Forty prompts sounds small next to the thousands of keywords a typical SEO tool tracks. That's deliberate. A model doesn't have a long tail of citation behavior the way a search index has a long tail of ranking behavior — it tends to converge on the same handful of sources for a given category of question, and widening the prompt list mostly adds noise rather than signal. We chose prompts a working engineer would actually type: "best vector database," "Pinecone vs Weaviate," "how to add distributed tracing to a Node service," and thirty-seven more like them.

FULL-BLEED IMAGE — 1000×520 · citation share by source type, all 40 prompts
Figure 1. Citation share by source type across all 40 tracked prompts, aggregated over eight weeks.

The three kinds of sources that win

Official documentation

Docs won most often, but not simply because they were official. They won specifically when they answered the question in the first paragraph rather than the fourth, and when the page carried something concrete to quote — a runnable snippet, a labeled table, a sentence structured like FAQPage markup even when no schema was present. A documentation lead at a mid-sized infrastructure company put it to us this way, after we shared an early version of these numbers with her team.

Comparison and roundup content

Blog posts won specifically when they named a competitor directly rather than describing a category in the abstract. "Best vector databases for 2026" loses to "Pinecone vs. Weaviate: a head-to-head" almost every time the prompt itself is a head-to-head, which is a meaningful share of the prompts a buyer actually types once they're past the awareness stage.

Docs win when they answer the question in the first paragraph. Blog posts win when they compare a brand by name.

Community answers

Forum threads and Q&A sites appeared rarely in our sample, and only for narrower, more technical prompts where no vendor had written anything comparable — a specific error message, an edge case in a migration path, the kind of question a docs team would consider too small to be worth a page.

What we found, by the numbers

Across all 40 prompts and roughly 1,400 individual runs, the citation share by source type broke down as follows. These are unrounded because rounding would flatter the numbers more than the data supports.

Source typeShare of citationsMost common model
Official docs41.2%ChatGPT
Comparison posts27.8%Perplexity
Community answers11.4%ChatGPT
Marketing / landing pages9.7%Gemini
Third-party benchmarks6.1%Perplexity
Other3.8%—

What this means if you write documentation

None of this is a secret formula, but it is a fairly specific set of changes, in a fairly specific order of impact:

  1. Answer the exact question in the first paragraph, before any setup, prerequisites, or context the reader didn't ask for yet.
  2. Add structured data that names what the page answers, not just what it's broadly about — a distinction most docs sites currently skip entirely.
  3. Publish a real, named comparison page if you're regularly asked about head-to-head against a specific competitor, rather than folding that comparison into a broader "alternatives" post.

A few caveats are worth stating plainly rather than burying in a footnote:

"We optimized our docs for humans skimming a page, not for a model quoting a single sentence out of context. Those turned out to be two different jobs, and we'd only ever done one of them."

The clearest way to see the first recommendation in practice is FAQ schema, since it forces the "answer in the first paragraph" instinct into a format a crawler can parse without guessing:

JSON-LD{
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "How to monitor brand mentions in ChatGPT"
  }]
}
INLINE IMAGE — 680×382 · before/after of a rewritten docs page
An inline image stays at column width, same caption treatment as the full-bleed figure above.

We made two of these three changes to our own site before running any of this analysis on ourselves, which is a separate piece of writing with its own honestly modest numbers. What we can say here, with more confidence than we can say almost anything else about this space right now, is that the pattern held across every category we tested: proximity of the answer to the top of the page mattered more than any other single variable we measured, including domain authority, page length, and publish date.

None of this is a guarantee, and it will keep shifting as the models change underneath it. That's the actual argument for measuring on a schedule instead of writing the advice once, publishing it, and treating the question as settled.

Priya Shah
Leads research at doclight. Previously spent four years on a developer relations team, on the other side of the citation gap.
XGitHub
Want this measured for your own site?
Join the waitlist — we'll email you when it's your turn, no pricing promises.
Join waitlist
Why Perplexity cites differently than ChatGPT, and what that means for your docs6 minStructured data doesn't fix bad writing, but it does help good writing get found5 minA methodology note: how we run 210 prompts a week without asking permission7 min