RDBTC-221 Migrate technical guides Migrating RDBTC-157

[Netzach-Nyss]

Issue link

RDBTC-157 AI Image Search with RavenDB Vector Search
RDBTC-221 Migrate technical guides and how-tos from ravend.net/articles to docs.ravendb.net/guides

Additional description

Content Quality Analysis: ai-image-search-with-ravendb.mdx

Content Quality Score: 86/100 (was 85)

Metric	Now	Verdict
Prose words	1,530	Above floor
Code	12 blocks	Appropriate
Flesch	61.3	In band
Grade level	8.8	Good
Avg sentence	16.6w	In band
Avg paragraph	2.4 sentences	In band
Heading hierarchy	H2×5, H3×2, no skips	Fixed
TOC entries	7	Good for the length
Internal links	7 (4.6/1k)	In band
Generic anchors	0	Fixed
Images	6/6 descriptive alt	Good

E-E-A-T Breakdown: 82/100 (unchanged)

Factor	Score	Key signals
Experience	21/25	Original screenshots, runnable code, the candid note about the demo's own default. No measured latency or recall.
Expertise	22/25	Real wiring shown, HNSW and tuning depth sourced from RavenDB docs. Capped by the empty author profile.
Authoritativeness	19/25	Seven internal links into the vector-search cluster, one strong external cite. Personal-account gist, live duplicate.
Trustworthiness	20/25	Fully reproducible, correct schema. Stale date, stale version floor.

Heading structure is a navigation and crawl signal rather than an E-E-A-T one, so the split moved the quality score, not this table.

AI Citation Readiness: 70/100 (was 68)

The ceiling is unchanged and is set by the same three things: no table, no Q&A block, no answer-first definition.

Issues Found

No new issues. Everything below is carried forward, and none of it can be resolved by further analysis.

#	Issue	Type
P1	ravendb.net/articles/ai-image-search-with-ravendb still indexable and self-canonical	Cross-team decision
P3	CLIP definition sentence still missing its subject (verified present)	One-word fix
P4	"AI image search" absent from body; "image search" absent from first 100 words	One-sentence fix
P5	published_at: 2025-09-09, twelve months stale; "RavenDB 7.0+" while Tuning describes 7.2	Small edit
P6	authors.json has url: null + placeholder avatar for this byline	Outside this file, affects 30 guides
P8	Setup code precedes the first screenshot	Your call, tradeoff not defect

Recommendations

We have reached the point where re-auditing returns almost nothing. The score has moved 72 → 82 → 85 → 86, and the last two increments came from structural fixes worth roughly a point each. The remaining backlog splits cleanly:

Two minutes of edits, and I can do them now: P3 (add "it"), P4 (work image search into the opening), P5 (version floor and a reviewed date).

Needs your decision: P8, the setup-before-hook ordering. My recommendation remains collapsing setup into an <Admonition>.

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)