[GHC] #12394: broken (obsolete?) links to user guide

[GHC]

#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