[V2] Handle /docs route

🚀 Feature

Currently navigating to /docs will result in a not found page being shown (unless pages/docs/index exists). I’m proposing that we handle this gracefully by redirecting to the first doc page.

Have you read the Contributing Guidelines on issues?

Yes

Motivation

Showing a not found page isn’t very helpful to a user that’s likely searching for the documentation.

In most cases, I can imagine the user wanting to be redirected to valid documentation.

Pitch

• Better UX for the end-user.
• Can link to /docs instead of a specific page which allows us to change or remove that page without breaking the links.
• Looking at the existing V2 showcase, they all link to the first page of docs anyway.

If we agree on a solution, I’d also be happy to implement it and open a PR.

[binarylogic]

Oh, and as a work around we did the following:

Add a src/pages/docs.js file with the following contents:

import React from 'react';
import {Redirect} from '@docusaurus/router';
function Docs() {
  return <Redirect to="/docs/my-doc" />;
}
export default Docs;

[endiliey]

Check https://docusaurus.io/ itself

There are Docs and Tutorial Section in headerlinks. Both have different sidebars. If i go to /docs, how do we know which one to choose ?

More problems go even more when versioning and translation came in. Do we go to /docs/en or /docs/ko or /docs/en/next or /docs/en/1.0.0 ?

The best solution is still creating your own “src/pages/docs/index.js” which is very flexible and let user decide