Editing navigation

When adding new pages to your documentation, you'll need to link them at some place in the navigation menu.

By default, the left-hand-side navigation of your documentation site is defined in the src/navigation.json file. Currently, only two-level navigation is supported.

The navigation JSON file groups pages (articles) in your site into chapters:

{
  "chapters": [
    {
      "title": "Getting started",
      "articles": [
        "getting-started",
        "quick-start"
      ]
    },
    {
      "title": "Basic usage",
      "articles": [
        "editing-navigation",
        "editing-pages",
        "code-blocks",
        "customization"
      ]
    },
    {
      "title": "Advanced topics",
      "articles": [
        "under-the-hood",
        "configuration-reference"
      ]
    }
  ]
}

The articles array lists identifiers of pages to link to the specific chapter. An identifier of getting-started, for example, will be mapped to content/getting-started.html.

Please note that a page will not appear in the menu until you create its corresponding HTML file. A warning will be logged to DevTools console.