How do maintainers handle documentation for multiple versions?

Question

Our project is about to release v2 with breaking changes. How do others keep v1 and v2 docs side by side without duplicating everything?

Tom Walsh · Accepted Answer

Most docs tools support versioning: Docusaurus has `docs:version`, MkDocs has `mike`. Snapshot v1 when you release v2, then only fix critical issues in the old version. Add a banner on old pages pointing to the latest.

How do maintainers handle documentation for multiple versions?

1 Answer

Log in to view all 1 Answer