Right now we use effectively the same mdbook workflow to build versioned docs sites for both Coop and Osprey:
The versioning is a little awkward UX-wise:
- The index page doesn't look great; it's barebones and looks like it's not meant for humans 😅
- When in the docs, it's not obvious which version you're browsing without looking at the URL
- When browsing old docs, it's not obvious you're not browsing the latest (which might be on purpose, but you should be doing it consciously!)
/latest is the latest unreleased docs; there's no /stable for the latest release
I don't mind the mdbook-generated sites themselves, but I think we could improve this with a few changes:
Right now we use effectively the same mdbook workflow to build versioned docs sites for both Coop and Osprey:
The versioning is a little awkward UX-wise:
/latestis the latest unreleased docs; there's no/stablefor the latest releaseI don't mind the mdbook-generated sites themselves, but I think we could improve this with a few changes:
/stablesymlink to the latest released version of the docs/to either/stableor/latest(I could be convinced either way)/latestdocs to flag that they're for the unreleased version