#4026: library documentation has unstable URLs
---------------------------------+------------------------------------------
Reporter: duncan | Owner:
Type: bug | Status: new
Priority: normal | Component: Documentation
Version: 6.12.2 | Keywords:
Os: Unknown/Multiple | Testcase:
Architecture: Unknown/Multiple | Failure: None/Unknown
---------------------------------+------------------------------------------
Currently google is returning URLs for ghc libraries that return 404, eg:
http://haskell.org/ghc/docs/latest/html/libraries/base-4.2.0.0/Data-
List.html
The new URL is with `base-4.2.0.1` rather than `base-4.2.0.0`.
This is not google's fault, it is our fault. We are using unstable URLs.
Of course, we cannot guarantee full stability as modules get added/removed
however we can do much better than breaking all URLs every time.
I suggest we have two sets of stable URLs, versioned URLs and
"latest"/unversioned URLs:
{{{
/ghc/docs/6.12.1/html/libraries/base-4.2.0.0/Data-List.html
/ghc/docs/latest/html/libraries/base/Data-List.html
}}}
This will either mean generating them separately so that links between
packages work, or using redirects such as:
{{{
/ghc/docs/latest/html/libraries/base-4.2.0.1/
->
/ghc/docs/latest/html/libraries/base/
}}}
so that we can generate the docs once and use them at both the "latest"
and ghc-versioned locations.
--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4026>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler
_______________________________________________
Glasgow-haskell-bugs mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
