search

nuxt / content

The file-based CMS for your Nuxt application, powered by Markdown and Vue components.
https://content.nuxt.com
MIT License
3.14k stars 628 forks source link

[theme-docs] Add versioning to allow multiple versions of documentation. #562

Closed robertdrakedennis closed 3 years ago

robertdrakedennis commented 4 years ago

Is your feature request related to a problem? Please describe.

No problem.

Describe the solution you'd like

Currently we only have badges to specify versions and while they are greatly appreciated, it would be really nice to have the ability to supply the docs theme with the ability to have multiple versions, similar to addons or features in vue-press.

Describe alternatives you've considered

Badges are fairly sufficient but they really don't add the UX or flexibility that separate folders for versions would.

Additional context

You can see examples of multiple versions like here: https://pterodactyl.io/panel/1.0/getting_started.html which is made in vue-press.

robertdrakedennis commented 4 years ago

The way I would have this work is maybe another folder inside one of the localization folders? example:


docs
-en
--v1.0.0
atinux commented 3 years ago

Hi @robertdrakedennis and thank you for the suggestion.

We don't want to support this honestly, it is too much work, adding badge is way much better for maintaining documentation. And when breaking changes arrises, better to move the old version to a sub domain, like v1.myproject.org