[V2] Versioning Suggestions

💥 Proposal

Hi! As I work on developing my Docusaurus site (https://squirrelly.js.org), I’ve noticed a few problems with the current versioning system.

1. Pages aren’t versioned. This is a problem for me because on one page I host a live playground, and the syntax changes completely between the new and old libraries.
2. docusaurus.config.js isn’t versioned. In my top bar, I link to different docs files. However, no matter what version I’m viewing, they always link to the latest docs (ex. /docs/ instead of docs/some-version/).
3. There’s no way to get the current version in your React Components, so, for example, on the Docusaurus site, the link next to Docusaurus always reads alpha.43, no matter what version you’re currently viewing.

With these problems in mind, I’d suggest having a public version variable. This could be provided to MDX files, similarly to withBaseUrl. It would also be nice if you could, in docusaurus.config.js, export a function that accepted a version string as the parameter.

Have you read the Contributing Guidelines on issues?

Yes

[lex111]

We will add the useVersion hook, the more we need it to show the version of docs in navbar.

[bravo-kernel]

Exactly, this:

If you want v4 and v5 as the same unified SPA under same domain: as far as I understand, what you would like is to have /docs instead of /docs/next ? ie v5 is the current “work in progress version”, and you want to edit files in ./docs directly?