pbokoc added a new comment to an issue you are following:
``
This isn't going to be trivial to fix. Here's what the problems are:

* Only three guides have been converted: Release Notes, Installation Guide, and 
System Administrator's Guide. AFAIK, at the moment there are no plans to 
convert anything else. This makes links to any *not* converted documents easy 
to fix, just replace https://docs.fedoraproject.org/ with 
https://docs-old.fedoraproject.org/, the paths are the same.

* The three converted guides live under new paths which aren't completely 
consistent: Release Notes went from `Release_Notes/` to `release-notes/`, 
System Administrator's Guide from `System_Administrators_Guide/` to 
`system-administrators-guide/`, BUT Install Guide went from 
`Installation_Guide/` to `install-guide`. That's still not too bad.

* The bad news is that the three converted guides also now have different 
paging rules, so links that went to specific chapters or sections may or may 
not work anymore - they could have been generated as anchors instead. To use a 
made-up but realistic example, a link that previously went to 
`Installation_Guide/Downloading_Media.html` may or may not need to point to 
something like `install-guide/Introduction.html#Downloading_Media`.

* Another issue is that we broke "latest" redirects. Some places (e.g. 
getfedora) used URLs to point to the latest published version of a certain 
book. I know of two: https://docs.fedoraproject.org/release-notes and 
https://docs.fedoraproject.org/install-guide. Those are now broken (the 404 
error again); if you change them to 
https://docs-old.fedoraproject.org/release-notes, they're still partially 
broken (no 404, but you land at the front page of the old docs site, not on the 
front page of the specific book).

* Speaking of redirects, it would be really nice if we could get those for the 
old site; if anyone accesses a F25 or earlier book, they should be redirected 
from docs.fp.o to docs-old.fp.o. Again, the paths are all the same. This would 
fix both the first problem I mentioned as well as any links on pages outside 
our control. Ideally we could combine this with a banner warning about 
(potentially) outdated content and pointing to the new site, but that's 
probably something the docs project should be handling; I opened an issue for 
this [here](https://pagure.io/docs-fp-o/issue/35).
``

To reply, visit the link below or just reply to this email
https://pagure.io/fedora-websites/issue/722
_______________________________________________
websites mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to