Thanks for this, can anyone recommend what actual tool they prefer to write, publish, and manage documentation with? I'm aware of Sphinx, etc but I'm considering just using one of the many markdown related static generators, is something with a back-end(cms) better?
I write technical docs in Asciidoc format using AsciidocFX, I use Asciidoctor to convert to HTML, and Asciidoctor PDF to convert to PDF - It's a workflow I'm really happy with.