Bug 254885 - link to handbook gives 404
Summary: link to handbook gives 404
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Danilo G. Baio
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-04-08 13:58 UTC by Dan Langille
Modified: 2021-06-26 20:05 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Dan Langille freebsd_committer freebsd_triage 2021-04-08 13:58:43 UTC
At https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/port-upgrading.html appears this text in the second paragraph:

When working with more than a few ports, it will probably be easier to use Subversion to keep the whole ports collection up-to-date, as described in the Handbook. 

"Handbook" links to https://docs.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html which is a 404
Comment 1 Li-Wen Hsu freebsd_committer freebsd_triage 2021-04-20 04:18:35 UTC
The issue is https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/port-upgrading.html is legacy page and the latest one should be https://docs.freebsd.org/en/books/porters-handbook/upgrading/

So the issue we need to fix is the SEO (the legacy URLs shouldn't be indexed by search engines and we should provide a better redirection to the latest pages.
Comment 2 Ceri Davies 2021-04-20 09:18:29 UTC
Is there any reason that the legacy content can't just be deleted?
It seems that deploying into a clean docroot would be a good start.
Comment 3 Danilo G. Baio freebsd_committer freebsd_triage 2021-06-26 20:03:17 UTC
There are redirects in place for almost all legacy links now.

$ curl -sLI https://docs.freebsd.org/en_US.ISO8859-1/books/porters-handbook/port-upgrading.html | egrep 'HTTP|Location'
HTTP/1.1 302 Moved Temporarily
Location: https://docs.freebsd.org/en/books/porters-handbook/upgrading/
HTTP/1.1 200 OK

Thanks for reporting it.
Comment 4 Dan Langille freebsd_committer freebsd_triage 2021-06-26 20:05:47 UTC
Fix confirmed here. Thank you.