Re: Directing old docs to new docs

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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: https://pagure.io/fedora-docs/docs-fp-o/issue/118
> 
> 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.

-- 
Cheers,
Justin W. Flory (he/him)
justinwflory.com
TZ=America/New_York

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux