[GHC] #12394: broken (obsolete?) links to user guide
#12394: broken (obsolete?) links to user guide -------------------------------------+------------------------------------- Reporter: j.waldmann | Owner: Type: bug | Status: new Priority: normal | Milestone: Component: Documentation | Version: 8.0.1 Keywords: | Operating System: Unknown/Multiple Architecture: | Type of failure: None/Unknown Unknown/Multiple | Test Case: | Blocked By: Blocking: | Related Tickets: Differential Rev(s): | Wiki Page: -------------------------------------+------------------------------------- A lot of place (Haskell Wiki, etc., example: bottom of https://wiki.haskell.org/Language_Pragmas) have links like this https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/ghc- language-features.html which gives 404 now. Is there a systematic way of redirecting this? It seems not, because actual names did change, the correct link should now be https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/lang.html The old name (URL) was just the section heading? Which seemed reasonable. The new one just looks like a file name. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12394 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#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: | -------------------------------------+------------------------------------- Changes (by thomie): * cc: bgamari (added) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12394#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#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
#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 thomie): Maybe `https://downloads.haskell.org/~ghc/latest` should be a redirect instead of a copy of the latest stable version. Then referrers will more likely create links to the latest stable version, instead of to "latest". -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12394#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC