[Netzach-Nyss]

Issue link

RDBTC-265 Guide: Building a RAG solution with RavenDB

Additional description

SEO re-review: Building a RAG solution with RavenDB

Content quality score: 84/100 (unchanged)

E-E-A-T breakdown

Factor	Score	Change	Key signals
Experience	22/25	−1	The retrieval numbers (27/26/24 of 28), the timing table and the 2-cents-per-question figure are all still there. Step 6 now picks gpt-5.5 without saying why.
Expertise	22/25	=	Same depth: the hash loop explanation, the if (this.Summary) guard, the required ChunkingOptionsForQuerying.
Authoritativeness	17/25	=	Still 1 link to another guide and 5 to the docs for about 5,500 words. The sample repo is still on a personal GitHub account.
Trustworthiness	23/25	+1	Removing the "doesn't work yet" model claims takes out the content most likely to go stale.

AI citation readiness: 76/100 (+4)

The definition under "What is RAG?" is now a clean, quotable sentence. The steps table, the measured results table and the "What we never had to write" table were already easy to quote.

Issues found

1. Internal links are still thin. This was recommendation 4 last time, which you didn't pick. Step 4 is the core of the guide, and it still has no link to the vector search docs. Candidates:

   • Step 2: ./embeddings-generation-with-ravendb
   • Step 4: ./new-in-7-0-ravendbs-vector-search and https://docs.ravendb.net/ai-integration/vector-search/vector-search-using-dynamic-query
   • Step 5: ./practical-look-at-ai-agents-with-ravendb
   • Line 515, "multi-agent setups": ./multi-agents

2. Step 6 doesn't say why it uses gpt-5.5 (line 486). The paragraph explains what the agent model has to handle, then just says "We use gpt-5.5." If you have the result from your 20 answer questions, one clause like "it answered N of 20 correctly" would restore the evidence without mentioning any model that failed. I don't have that number, so I didn't add it.

3. Minor, carried over:

   • There's no image in the frontmatter, which guide cards and social previews could use.
   • The sample repo is at github.com/poissoncorp, not under the ravendb org.

Type of change

• Content - docs
• Content - cloud
• Content - Quill
• Content - guides
• Content - start pages/other
• New docs feature (consider updating /templates or readme)
• Bug fix
• Optimization
• Other

Changes in docs URLs

• No changes in docs URLs
• Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

• No changes in UX/UI
• Changes in UX/UI (include screenshots and description)