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 - the 404 page will explain what to do.
Things can improve now, if you spot a missing guide in the menu, or want to change something, it is easy to do. I also migrated the static site to
nanoc which is trivial ERB-based Ruby site generator - much easier for our 5 pages than the previous one.
Next step for me is to convert our current Foreman documentation to asciidoc and start improving and modularizing the content.