Bring documentation to Read the Docs

[amotl]

Hi,

coming from #389 (comment), I've finally made a start on publishing a rendered version of the documentation.

The previous single-page HANDBOOK.md has grown to almost 4000 lines, and became unbearable. It has been dissolved now.

The three main pillars of documentation, where most content has been refactored to, are "Services", "Topics", and "Transformations" now, resembling the very core of mqttwarn. You will find them at the "Configuration" section of the documentation ¹. On the other hand, the grand catalog of notifier plugins is now on a dedicated page ², and it's still single-page, because tearing it apart would also be unbearable.

While working on the refactoring, I've diligently edited each and every piece of text I've actually moved, applying spring-cleaning-like tasks, and adjusting phrasing and wording towards active voice. The same kind of editing should also be applied to the single-page notifier catalog, which has been moved over verbatim. However, I will not have the capacity for that right now, so I am postponing it to a subsequent iteration.

The documentation can be explored at https://mqttwarn.readthedocs.io now. Enjoy.

With kind regards,
Andreas.

Footnotes

1. https://mqttwarn.readthedocs.io/en/latest/configure/ ↩

2. https://mqttwarn.readthedocs.io/en/latest/notifier-catalog.html ↩