Docs Site Playground
Last updated
On this page
This space exists to test the public docs site reader (CADE-911). Publish it from Space settings → Docs site, preview it, make it live, and walk through every page. Delete the space when you're done.
Note
This is the space's home page, so it's the page the site opens on.
What each section tests#
| Section | What to check |
|---|---|
| Getting started | Code blocks with copy, all five callouts, an include from another page, links to a section of another page, a page card |
| Guides | Every inline style, lists, quotes, footnotes, toggles, a long page for "On this page", a page three levels deep, a very long title |
| Reference | Headings H1–H6, wide and merged tables, code in many languages, what happens to each kind of link, embeds, images, formulas |
| Changelog | A top-level page with nothing under it: a tab with no sidebar |
What must not appear#
Secret roadmap: a draft at the top level.
Unfinished guide: a draft inside Guides.
Old API: deprecated, and the published page under it.
None of them should be in the navigation, and their addresses should be the plain 404 page.
Things to try on the site#
Switch between light and dark, and check the code colours change with it.
Narrow the window below 1280px: "On this page" moves to the top of the article.
Open it on a phone: the sidebar becomes a drawer, and nothing scrolls sideways.
Set a logo, an accent colour, header links and a footer line in the space's Docs site settings, publish again and check each one.
Rename a page, publish again and make it live: its old address should send you to the new one.