Skip to content

RDoc-4149 Templates sidebar doesn't show all pages - #2711

Open
poissoncorp wants to merge 1 commit into
mainfrom
templates-sidebar-noindex
Open

poissoncorp wants to merge 1 commit into
mainfrom
templates-sidebar-noindex

Conversation

@poissoncorp

@poissoncorp poissoncorp commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Issue link

https://issues.ravendb.net/issue/RDoc-4149/Templates-sidebar-doesnt-show-all-pages

Additional description

On production builds the /templates sidebar listed only "Samples authoring" and "Gallery example"; the other pages were reachable only by URL. They had unlisted: 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 ignores unlisted, so it showed everything.

  • templates/*.mdx: removed unlisted: true from the 12 pages that had it.
  • docusaurus.config.ts: the templates docs instance sets versions: { current: { noIndex: true } }, so Docusaurus emits noindex, nofollow on 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 use unlisted there.

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.mdx from #2707 also adds unlisted: true; drop it in whichever PR merges second.

Verified on a production build (build:current with DOCUSAURUS_STRICT and DOCUSAURUS_STRICT_SEO) served with docusaurus serve: all 19 /templates pages carry a single noindex, 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

  • 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)

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.

@poissoncorp
poissoncorp requested a review from Lwiel October 23, 2026 00:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants