Skip to content

library documentation has unstable URLs

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.

Trac metadata
Trac field Value
Version 6.12.2
Type Bug
TypeOfFailure OtherFailure
Priority normal
Resolution Unresolved
Component Documentation
Test case
Differential revisions
BlockedBy
Related
Blocking
CC
Operating system
Architecture
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information