Skip to main content
The D-Sports docs navigation (Guides and API reference tabs, with groups like Getting started and Repositories) is defined in docs.json. When you add a new page to this repo, you must add it to the right group in docs.json or it will not appear in the sidebar. Our navigation syntax is recursive which means you can make nested navigation groups. You don’t need to include .mdx in page names. 
"navigation": {
  "tabs": [
    {
      "tab": "Docs",
      "groups": [
        {
          "group": "Getting Started",
          "pages": ["quickstart"]
        }
      ]
    }
  ]
}

​
Folders

Simply put your MDX files in folders and update the paths in docs.json. For example, to have a page at https://yoursite.com/your-folder/your-page you would make a folder called your-folder containing an MDX file called your-page.mdx.
You cannot use api as a top-level folder name (Next.js reserves it). Use something like api-reference instead — as in this repo.
Navigation With Folder
"navigation": {
  "tabs": [
    {
      "tab": "Docs",
      "groups": [
        {
          "group": "Group Name",
          "pages": ["your-folder/your-page"]
        }
      ]
    }
  ]
}

​
Hidden pages

MDX files not included in docs.json will not show up in the sidebar but are accessible through the search bar and by linking directly to them.