It'd be nice to see these docs get a banner, ideally with a new link to click to the latest docs. The banner is a good MVP. We also need to get a banner on to the really really old docs ...

I hope this can be scripted, even given that our old docs followed different formats/tech :pray:

Should this be added as part of the docs team's release cycle related tasks----"mark EOL docs as such"?

This is a good point. Having a banner there would make sense. Help with implementing this is more than welcome!

Would you know where someone interested in this should start? Lots of questions: :smile:

How are the EOL pages to be modified? Didn't they use publican back in the day, for example? Will one have to modify the source and re-generate them, or does one simply add to the HTML---if so, where are the HTML sources?

It's probably better to modify the sources, not generated HTML.

How about this: A while ago someone on the docs list proposed creating a "shared partials" repo: https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/message/OUDAIOBDKTMQOSMHAPLDIYVD2KXZC4JK/. I still didn't get around to it, but when I make it, we could store the banner there - just a simple file with a [NOTE] saying this documentation is outdated and pointing to the docs front page where people can find up to date docs.

Then we could write a script that inserts an include pointing to the banner into every page in each module on branches for EOL releases.

I can see a few issues with this, though:

• The banner would show up on top of each page, so if any user lands on an anchor in the middle of a longer page, they won't necessarily see it.

• I'm not sure off the top of my head, but I think some of our docs have pages composed of multiple source files. Doing this would make the banner show up in multiple places on a single page, which would look weird. We could go through each doc and make sure that either one page = one source file, or that any sources that aren't top-level pages are in _partials, but that's a lot of extra work.

Now that I wrote all that I thought of a second approach. @asamalik do you know if it's possible to set the UI bundle (or layout) per repo/branch instead of setting it for the whole site? We could make another bundle (or another layout in the default bundle) that has a huge floating banner on top - is that possible?

Building on this, for pre-Antora docs, I encourage us to modify the HTML directly as we are unlikely to be able to easily regenerate those pages from source again.

Yes, that's true, we don't have any other choice than to modify the output for pre-Antora docs.

Yes, that's true, we don't have any other choice than to modify the output for pre-Antora docs.

Created #118 specifically for pre-antora docs, and editing the title here to make it specific to antora docs from now on.

If we implement #16, it should be possible to add a banner for documentation pages which are not latest.
Instead of saying "This version is EOL", we could just say "This is not the latest version, here is the link to the current one" or something like that.
Another solution is to create a component attribute is_eol that we can set to true for each version we want to deprecate. The ui-bundle will track that variable and display, or not, the banner.