Converting our manual to AsciiDoc (preview)

[lzap]

So with the navigation out of the way:

Documentation site navigation is live

Hey, after a lot of evenings I was able to finalize my work on the navigation bar for our documentation site. It is all dynamic, meaning that contents of the menu is loaded via /js/nav.js data structure. This means that guides generated with asciidoctor can also have the same navigation bar, so the user experience is the same across the whole site. I had to regenerate also stable branches 3.1, 3.0 and 2.5. I deleted 2.4 and 2.3 guides it was too much work backporting the changes for no benefit…

I am going to proceed with moving our current documentation unchanged to the new site and format. First I will do Foreman, then I will work on plugins. For them, I think the best way will be to modularize them and then incorporate them into other guides, bigger plugins will likely have their own guides too.