Implement the releases as a data source

[ekohl]

Previously there was one huge file for all the versions in the navigation. In addition to that, there were individual release pages. This was difficult to maintain.

The new way uses Nanoc data sources to essentially act as a database. Based on that, the various release pages are generated from a single source. For that, guides are identified by tags so they can be renamed without affecting the website. The releases on the index page are also generated.

That allows easy copying when a release is branched and provides an easy overview which builds belong to which release.

There is still some room for improvement. A lot of content in the release file overlaps with the content in guides. If it could be extracted from guides, that would reduce maintenance even further.

This is a more native way of implementing #2840. The primary benefit is that it's aware of the release files and pages are live rerendered when a change is made.

This is a draft because not all release have implemented the tags.

• I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

• Foreman 3.10/Katello 4.12
• Foreman 3.9/Katello 4.11 (planned Satellite 6.15)
• Foreman 3.8/Katello 4.10
• Foreman 3.7/Katello 4.9 (Satellite 6.14)
• Foreman 3.6/Katello 4.8
• Foreman 3.5/Katello 4.7 (Satellite 6.13; orcharhino 6.6/6.7)
• Foreman 3.4/Katello 4.6 (EL8 only)
• Foreman 3.3/Katello 4.5 on EL7 & EL8 (Satellite 6.12 on EL8 only; orcharhino 6.4/6.5 on EL8 only)
• We do not accept PRs for Foreman older than 3.3.

[github-actions]

The PR preview for 79ca6d3 is available at theforeman-foreman-documentation-preview-pr-2845.surge.sh

The following output files are affected by this PR:

show diff

show diff as HTML

[ekohl]

This is a draft because not all release have implemented the tags.

And in addition to that: the release pages also contain links to guides with similar names. The links on overview are also broken. But I'm calling it a day.

[ekohl]

I have dropped the dynamic per-release page and moved to static pages. fb3e7f9 is a commit I wrote that does it mostly, but I'm not happy with it yet and I don't want to block the whole effort on it.

Please take a look and let me know what you think.

[Lennonka]

Brilliant, I love it!
Not sure I'm qualified to comment on the code.
Have you tested it locally?

[maximiliankolb]

Thanks Ewoud!

I had a look at the adoc and json files; they look sane to me. If you feel confident, please merge and let's try it out!

[evgeni]

needs a rebase after 967b8c8 but otherwise 👍

[ekohl]

Updated the README to change the nightly.json and nightly.adoc files. Also added katello to nightly.json so on branching you only need to update the value instead of adding a line.