Skip to content

Docs site: add a catalogue of unlisted pages - #49

Merged
avsolatorio merged 4 commits into
worldbank:mainfrom
avsolatorio:docs/unlisted-catalogue
Oct 23, 2026
Merged

avsolatorio merged 4 commits into
worldbank:mainfrom
avsolatorio:docs/unlisted-catalogue

Conversation

@avsolatorio

Copy link
Copy Markdown
Member

Adds microdata-documentation to the hidden list in website/cookbook-visibility.json. The cookbook stays in the repository and is built, but its pages are unlisted: no landing card, no overview group, no reading path, no readiness-map link, no search or sitemap entry, a noindex tag and a banner, and its cookbook-files folder is removed from the build. A direct link still opens the pages for reviewers.

The checker fails when a public page links into a hidden cookbook, and 33 links from eleven public cookbook chapters and two documentation pages pointed into this one. Those links are turned into plain text with the same wording, so the references remain and can be relinked from the history when the cookbook is published again. website/src/content/investment.json is regenerated, since the generator skips hidden cookbooks.

The cookbook checker passes with no errors. No readiness-map question depends only on links into this cookbook.

Also adds a catalogue of unlisted pages at /unlisted (website/src/pages/unlisted.js): every hidden cookbook with links to its chapters, read from the docs plugin's build data, and the standalone unlisted pages. The page is itself noindex, out of the sitemap and the search index, and linked from nowhere. allCookbooks is exported from cookbooks.js for it. Verified in a local build.

@avsolatorio avsolatorio changed the title Docs site: hide the microdata documentation cookbook and add a catalogue of unlisted pages Docs site: add a catalogue of unlisted pages Oct 23, 2026
@avsolatorio
avsolatorio merged commit 8431c1a into worldbank:main Oct 23, 2026
1 check failed
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.

1 participant