tectonic
tectonic copied to clipboard
Add versioning to your documentation
It seems to me that the documentation (read: "the book") always points to the latest development version.
This can lead to issues like #1243 where a user reads something in the documentation, tries to use it and fails because the version installed was the latest release.
I would suggest to,
- deploy the documentation on a public service that allows for versioning (like e.g. ReadTheDocs
- add a automatic changelog to your documentation
Another issue opened due to this: #1225
I was about to open an issue myself due to this. Until versioning is introduced, perhaps a banner should be introduced on the docs indicating that they reflect the current development status, not necessarily the latest release.