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