#12394: broken (obsolete?) links to user guide -------------------------------------+------------------------------------- Reporter: j.waldmann | Owner: Type: bug | Status: new Priority: normal | Milestone: Component: Documentation | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): There are sadly few satisfying ways to deal with this. All-in-all, neither Sphinx nor DocBook provide terribly satisfying solutions to the problem of stable links into documentation. The few solutions I can think of are all quite terrible, 1. Include a link to the index page of the current documentation in the 404 handler in the `users_guide/` directory 2. Try to manually build a map of redirects from the old URLs to the new pages. I had previously started this but the task ate through its time allowance and I dropped it. Moreover, it wasn't clear that this solution was going to be maintainable going forward given that documentation may continue to change. I'd love to hear suggestions on how to proceed though. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12394#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler