SEO Optimization: Sitemap and duplicate "RavenDB Documentation"#2381
Merged
ppekrol merged 4 commits intoravendb:mainfrom Apr 2, 2026
Merged
SEO Optimization: Sitemap and duplicate "RavenDB Documentation"#2381ppekrol merged 4 commits intoravendb:mainfrom
ppekrol merged 4 commits intoravendb:mainfrom
Conversation
Remove "RavenDB Documentation" prefix from homepage frontmatter title to prevent duplication with the site-wide title suffix, changing the rendered title from "RavenDB Documentation — ... | RavenDB Documentation" to "Guides, API Reference & Tutorials | RavenDB Documentation".
Replace the single flat sitemap.xml (800+ URLs) with a sitemap index that references per-section sub-sitemaps: docs (per version), cloud, guides, and misc. Legacy versions below 6.0 are excluded. Runs automatically after `npm run build` and `npm run build:current`.
Lwiel
reviewed
Apr 2, 2026
parseFloat("7.11") < parseFloat("7.2") would incorrectly exclude
version 7.11. Compare major and minor parts as separate integers.
Lwiel
approved these changes
Apr 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Additional description
<title>tag — was rendering as "RavenDB Documentation — Guides, API Reference & Tutorials | RavenDB Documentation", now renders as "Guides, API Reference & Tutorials | RavenDB Documentation"sitemap.xml(800+ URLs) with a<sitemapindex>referencingsitemap-docs-{version}.xml,sitemap-cloud.xml,sitemap-guides.xml, andsitemap-misc.xml. Improves crawl management for search engines and provides clearer segmentation in Google Search Console.Changes
docs/home.mdxRemove redundant "RavenDB Documentation —" prefix from frontmatter title since the Docusaurus site title suffix already provides brand context.
scripts/split-sitemap.js(new)Post-build script that:
sitemap.xmlsitemap.xmlwith a standard<sitemapindex>sitemap.xmlor no URLs foundpackage.jsonChain
node scripts/split-sitemap.jsafterdocusaurus buildin bothbuildandbuild:currentscripts.Build output example
When building all versions, each version >= 6.0 gets its own
sitemap-docs-{version}.xml.Type of change
/templatesor readme)Changes in docs URLs
/scripts/redirects.jsonfile, setDocuments MovedPR label)Changes in UX/UI