Resurrecting this

On Tue, Mar 3, 2020 at 4:25 PM Justin W. Flory <> wrote:
On 3/2/20 3:37 PM, Ankur Sinha wrote:
> On Mon, Mar 02, 2020 14:33:58 -0500, Ben Cotton wrote:
>> Hi Docs team,
>> I had a chat this morning with Brian Proffitt (cc'ed), community
>> wizard and all-around great guy at Red Hat. One thing we discussed is
>> the apparent lack of release notes beyond F26. I say "apparent"
>> because I know they're produced, and I know how to find them, but if
>> you just search "Fedora release notes", you end up in the old
>> Publican-based site.
>> I'm sure this has been discussed before, but I'd like to bring it up
>> again: how can we easily direct people from the old docs to the new?
>> I don't think we want to remove them, because it's good for historical
>> reference to have them around, but it would be nice if we could easily
>> put a banner or something across the top saying "these are historical,
>> click here for the latest docs".
>> I know Publican generated the whole of the site, so I'm not sure how
>> easy it would be to go shoehorn that in. Another approach would be to
>> run all of the old content through pandoc and rebuild in the new
>> system. That sounds terrible.
>> To a large degree, this is an SEO problem, not a docs problem, but
>> "solving" it as a docs problem seems a lot easier. What do y'all
>> think?
>> One thing I'm going to do is add a link to the top of the ChangeSet
>> wiki pages post-release that links to the Release Notes.
> Related ticket:
> We didn't quite find a simple way of doing this, but yes, it needs to be
> done.
> Dropping them entirely was suggested, given that they're archived in the
> internet archive anyway.

I am in favor of taking old docs offline. It is an SEO problem.

As someone who shares this frustration and has seen this frustration
shared by others in user communities on Telegram, Reddit, and downstream
communities, I think they provide little practical value in 2020. Ankur
brings up a good point that they are available in the Internet Archive.

One thing that would help preserve historical hyperlinks across the Web
*and* boost SEO is to create redirect rules from old URLs to the new
docs. Search engines pick this up and boost the newer docs up in search
rankings faster than it would be just taking them offline.

Redirects here have the same problem as adding a banner.  The old docs site is raw html that we don't have the capacity to recreate from source.  Therefore adding the banner turns into writing a script/manually editing every single page. 

The redirects add a dimension of deciding if you want to try to redirect to a related successor doc or dump people back on the starting page.




Justin W. Flory (he/him)

docs mailing list --
To unsubscribe send an email to
Fedora Code of Conduct:
List Guidelines:
List Archives:

Brian "bex" Exelbierd (he/him/his)
RHEL Product Management & Community Architect
@bexelbie |