Adding docs home page to the sidebar

🐛 Bug Report

Trying to include a home page in the sidebar makes it point to a non-existing original URL.

Note: previously I have added is as a href link, however sidebar presence on the home page wasn’t stable, and it never appears in 2.0.0-alpha.56 (apparently because of #2785).

Have you read the Contributing Guidelines on issues?

Yes

To Reproduce

1. Create a docs/introduction.md page
2. Configure @docusaurus/plugin-content-docs with homePageId: 'introduction'
3. Add "introduction" to the sidebars file

Expected behavior

Add an Introduction element to the sidebar, that points to the routeBasePath.

Actual Behavior

The link is created, however it points to /introduction page, which doesn’t exist.

Your Environment

• Docusaurus version used: 2.0.0-alpha.56
• Environment name and version (e.g. Chrome 78.0.3904.108, Node.js 10.17.0): Chrome 81.0.4044.138, Node.js 14.3.0
• Operating system and version (desktop or mobile): Arch Linux

Reproducible Demo

1. Clone https://github.com/ark120202/moddota.github.io
2. Checkout docusaurus-issue-home-page-sidebar branch
3. Run npm ci
4. Run npm run start and go to http://localhost:3000/
5. Click on the Introduction label in the sidebar

[lex111]

Fine, thus, for example, the document id of introduction is set as the docs home page (homePageId: 'introduction'), then the route for it will not be generated (docs/introduction), and its contents will be available by the docs home page route (/docs). I will try to ship it to the next release.

[ark120202]

Yeah, I think it makes sense to have no non-canonical route at all. Even if sidebar would include only canonical url, it still might be linked manually, making Google still index it