[BUG] Documentation links broken #959
Description
Describe the bug
To Reproduce
See #958, outside links into the documentation have broken.
The documentation URLs have been stable for years and we are likely to break more outside of the repository.
Expected behavior
Previous links should work. One can go to icalendar version 6 and just change the version and is redirected to some kind of page that makes sense.
Closing criteria
Make sure that these links redirect to a documentation page that is likely to have the desired content:
- cli.html
- about.html
- api.html
- license.html
- install.html
- index.html
- usage.html more examples link in README failed (404) #958
- search.html
- security.html
- contributing.html
- changelog.html
- credits.html
- maintenance.html
Add configuration for sphinx-reredirects from old links to new in docs/conf.py.
-
/usage.html->/how-to/usage.html -
Add any other links
-
Add configuration for sphinx-notfound-page. See:
- https://github.com/plone/documentation/blob/5b0622760031891e064d228a3a7418ca6d73c1b8/docs/conf.py#L47-L48
- https://github.com/plone/documentation/blob/5b0622760031891e064d228a3a7418ca6d73c1b8/docs/conf.py#L380-L383
- https://github.com/plone/documentation/blob/5b0622760031891e064d228a3a7418ca6d73c1b8/docs/_templates/404.html