Bug 254885 - link to handbook gives 404
Summary: link to handbook gives 404
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc (Nobody)
Depends on:
Reported: 2021-04-08 13:58 UTC by Dan Langille
Modified: 2021-04-20 09:18 UTC (History)
2 users (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Dan Langille freebsd_committer 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 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.