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 - the 404 page will explain what to do.

https://docs.theforeman.org/

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.

3 Likes