#722 Xfce "Download/Using/Installing" links are broken
Closed: Fixed 3 years ago Opened 3 years ago by frafra.

Download/Using/Installing links are broken: https://spins.fedoraproject.org/xfce/download/index.html


This is an issue that cannot be discovered using https://validator.w3.org/checklink because those links point to https://docs.fedoraproject.org/_images/404.html but the server returns 200 as HTTP response instead of 404.

Well there is even more.
Paths are convertible only for some specific guides, not for all guides, anchors might not work because the pages changed and so the ID is not correct anymore, and even the name of the guides changed.
I filed a ticket in the docs pagure to track the issue and to make the correct changes even for the future (not sure if we will keep docs-old).

The issue affects all websites, not only labs, I will also add the links of the tickets to bugzilla and ask.fpo where this came up already.

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. There are other changes in the paths but those seem to be 100% consistent.

  • 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.

This is an issue that cannot be discovered using https://validator.w3.org/checklink because those links point to https://docs.fedoraproject.org/_images/404.html but the server returns 200 as HTTP response instead of 404.

This will need to be fixed in an infra ticket. I've opened https://pagure.io/fedora-infrastructure/issue/6349

Regarding links - there is a proposal to have the current release available as /current to ensure links keep working.

Any opinions?

CC: @immanetize

Ok, as we don't have time to wait if /current URLs will work in time, I went through all websites and replaced the main broken links with the f26/ docs.
This means:

  • Labs and Spins docs links should be all fixed
  • All footers should point to the correct Installation Guide
  • Release notes, Install guides and verify pages also are working correctly and point to the right section

There might be still some links which are not pointing to the right place, I'll figure that out during the next week.

I'm closing this ticket for websites, it's more a docs issue now.
However, we will need to get back to this as soon as latest or current links are in place. A new ticket will follow up the discussion here, specifically for that.

Metadata Update from @robyduck:
- Issue close_status updated to: Fixed
- Issue status updated to: Closed (was: Open)

3 years ago

Login to comment on this ticket.

Metadata