Build a help centre
At the end of this tutorial Rue Verte Cycles has a published help centre, "Bike care", with a sidebar, sections and step-by-step guides.
A docs area is a Docs home with Doc pages under it. A doc page can hold more doc pages, up to three levels below the docs home. Doc pages right under the docs home work as sections; the pages under them are the guides.
For the workshop:
| Level | Page |
|---|---|
| Docs home | Bike care |
| Section | Everyday care |
| Guide | Fix a puncture |
| Guide | Adjust your brakes |
| Section | Servicing |
| Guide | Prepare your bike for a service |
Published docs pages show a sidebar of the whole area, a breadcrumb, an On this page list of the page's headings, and Previous and Next links.
- In the dashboard, open Pages and choose New page.
- Under Type, choose Docs home.
- Type the Title "Bike care". The Slug becomes bike-care.
- Choose Create page.

The docs home opens empty in the editor. Its blocks (the sections of a page) come from Add blocks, as on any page: add a short introduction in a Text block and, if you like, Feature cards that link to each section.
- On Pages, choose New page.
- Under Type, choose Doc page.
- Under Parent, choose Bike care.
- Type the Title "Everyday care" and choose Create page.
- Repeat for "Servicing".
Write a sentence or two on each section page saying what its guides cover.
- Create a Doc page with the Parent "Everyday care" and the Title "Fix a puncture".
- In the editor, open Add blocks. The Docs group holds the blocks made for docs pages.
- Build the page from them:
| Block | Use it for | Example |
|---|---|---|
| Heading | A part of the page, at Level 2 or Level 3. It is listed in On this page | "Find the hole" |
| Text | Steps and explanations, with lists and links | The numbered steps |
| Callout | A Note, Tip, Warning or Danger set apart from the text, with a Title and Text | Warning: "Let all the air out before you take the tyre off." |
| Table | Values to compare | Tyre pressures by tyre width |
| Code block | Exact text to copy, with a copy button | A setting or a command |
| Tabs | Two to five alternatives, one shown at a time | "Tube" and "Tubeless" |

A doc page shows its title as the main heading, under the breadcrumb, so start the content with a Text block or a Level 2 heading rather than a hero.
- With no block selected, the right panel shows the page settings. Find the Doc page section.
- Under Sidebar label, type a short name, such as "Punctures". Leave it empty to use the title.
- Previous and Next are set to Automatic, which follows the order of the pages. Choose another page, or None, to change them.
- Choose Save.

The sidebar follows the order of the doc pages on the Pages screen.
- Open Pages.
- Open the actions menu of a doc page and choose Move up or Move down.
- Repeat until each section and guide sits where you want it.

The same Move up and Move down are in the editor's Pages panel.
To filter the list to the docs area, choose Show: Docs.
- Open Overview and choose Publish all.
- Check that the docs home and every doc page are selected.
- Choose the Publish button with the item count.
Publishing a doc page also updates the pages that link to it, such as its neighbours' Previous and Next links.
Link to the help centre from the header menu on Header & footer, then publish Header & footer. Reference: Build a docs area.
