monit-general
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Improvement suggestion: versioned documentation


From: Nils Steinger
Subject: Improvement suggestion: versioned documentation
Date: Sun, 24 Sep 2017 17:47:02 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0

Dear Monit developers,

currently, the online documentation only covers the most recent Monit
version: https://mmonit.com/monit/documentation/monit.html
However, due to packaging delays and version freezes for various *nix
distributions, it is often not possible to have the most recent version
installed at all times.

It would be very helpful to keep the documentation for previous versions
online when a new version is released.
That way, a user could quickly check the docs for their Monit version
without having to connect to their actual Monit machine.
It would also make it possible to run diff on two documentation versions
to get a quick overview of any new features or changed configuration
options (more concise and less confusing than digging through all
release notes, since the changes from one release might have been
changed again by a later one).

The change could be as easy as renaming monit.html to something like
monit-5.23.html and symlinking monit.html to the most recent version on
your server.
Alternatively, there are also externally hosted solutions like
readthedocs.org that can re-generate the directory structure
automatically whenever a new commit is made or a new version is
released.

Could you please consider implementing this?
The usability improvement it provides would be much appreciated.

Kind regards,
Nils Steinger



reply via email to

[Prev in Thread] Current Thread [Next in Thread]