Repository navigation
RDoc-4149 Templates sidebar doesn't show all pages - #2711
Open
poissoncorp wants to merge 1 commit into
Open
poissoncorp wants to merge 1 commit into
poissoncorp wants to merge 1 commit into
Conversation
Lwiel
approved these changes
Oct 23, 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
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.
Issue link
https://issues.ravendb.net/issue/RDoc-4149/Templates-sidebar-doesnt-show-all-pages
Additional description
On production builds the
/templatessidebar listed only "Samples authoring" and "Gallery example"; the other pages were reachable only by URL. They hadunlisted: true, and Docusaurus hides an unlisted sidebar link unless it is the active page (and a category whose items are all hidden). The dev server ignoresunlisted, so it showed everything.templates/*.mdx: removedunlisted: truefrom the 12 pages that had it.docusaurus.config.ts: thetemplatesdocs instance setsversions: { current: { noIndex: true } }, so Docusaurus emitsnoindex, nofollowon every route of the instance, the same way legacy versions are noindexed.src/theme/DocItem/index.tsx: removed the templates-only robots meta, now covered by the instance setting.CLAUDE.md: templates noindex comes from the instance config; don't useunlistedthere.Indexing doesn't change: every templates page keeps
noindex, nofollow, robots.txt is unchanged, and no sitemap lists them. Only the sidebar within the section changes.templates/tabs.mdxfrom #2707 also addsunlisted: true; drop it in whichever PR merges second.Verified on a production build (
build:currentwithDOCUSAURUS_STRICTandDOCUSAURUS_STRICT_SEO) served withdocusaurus serve: all 19/templatespages carry a singlenoindex, nofollow, no sitemap lists a templates URL, robots.txt is unchanged, and the sidebar lists every page in both categories. Lint, Prettier and typecheck clean.Type of change
/templatesor readme)Changes in docs URLs
/scripts/redirects.jsonfile, setDocuments MovedPR label)Changes in UX/UI
The templates sidebar now lists all pages on production, not only "Samples authoring" and "Gallery example". The "Unlisted page" banner on those pages is gone.