supervision icon indicating copy to clipboard operation
supervision copied to clipboard

Allow documentation versioning

Open capjamesg opened this issue 2 years ago • 10 comments
trafficstars

capjamesg avatar Aug 10 '23 19:08 capjamesg

Hello there, thank you for opening an Issue ! 🙏🏻 The team was notified and they will get back to you asap.

github-actions[bot] avatar Aug 10 '23 19:08 github-actions[bot]

I really like this idea! You can use mike to retain multiple versions of documentation. I'm setting it up for another project right now. Note that mike replaces mkdocs commands, so there would be slight changes in how we deploy the docs.

Happy to implement this if we want it!

capjamesg avatar Aug 10 '23 19:08 capjamesg

Hi, @capjamesg 👋🏻! As I understand it, mike is built on top of mkdocs. So our docs would visually look the same?

SkalskiP avatar Aug 11 '23 09:08 SkalskiP

@SkalskiP Yep! They would look the same. mike would add a dropdown for versions.

capjamesg avatar Aug 11 '23 10:08 capjamesg

@capjamesg Awesome! Can you work on a PR for the supervision-0.14.0 release?

SkalskiP avatar Aug 11 '23 10:08 SkalskiP

Yep! I'll do this in addition to the CONTRIBUTING.md updates before the next release!

capjamesg avatar Aug 11 '23 11:08 capjamesg

Awesome! In that case, I'll add it to our plan for supervision-0.14.0

SkalskiP avatar Aug 11 '23 11:08 SkalskiP

Can we also add how to modify documentation in case of modifying existing feature and adding a new feature?

hardikdava avatar Aug 11 '23 17:08 hardikdava

I'm working on this. I'm having a problem getting the version dropdown to show in the docs navigation bar. I'll keep working on it!

capjamesg avatar Aug 15 '23 12:08 capjamesg

@capjamesg Can't wait to see that! Any chance we could create docs for previous versions of supervision? We have git tags for all previous releases.

SkalskiP avatar Aug 15 '23 13:08 SkalskiP

Today we deploy multi version via mike and also deploy old versions as well.

@SkalskiP thank you for your administration help.

onuralpszr avatar Jan 29 '24 12:01 onuralpszr