[Haskell-cafe] Page rank and GHC docs directory organization

Johan Tibell johan.tibell at gmail.com
Thu Jul 22 11:17:17 EDT 2010


On Thu, Jul 22, 2010 at 4:33 PM, Ryan Newton <rrnewton at gmail.com> wrote:

> GHC docs seem to have the problem that newer versions only gradually
> overtake older ones in page rank, resulting in the effect that if one
> uses Google to find library documentation, they may accidentally look
> at an old version.  For example, if I google "Data.Data Haskell" the
> first link brings me to:
>
>  http://www.haskell.org/ghc/docs/6.10.2/html/libraries/base/Data-Data.html
>
> Oops, version 6.10.2!
>
> I'm no web expert, but I think the problem is that the "latest"
> directory isn't used consistently by others and/or the fact that
> latest/ redirects to a concrete version number.  Thus if you go to:
>
>
> http://www.haskell.org/ghc/docs/latest/html/libraries/base/Data-Data.html
>
> It redirects immediately to 6.12.2:
>
> http://www.haskell.org/ghc/docs/6.12.2/html/libraries/base/Data-Data.html
>
> So is the 6.12.2 target accruing pagerank rather than the latest one?
> Even if someone links the /latest/ URL?  If that's the problem, would
> it fix things just to make latest/ a full directory structure in its
> own right (a clone rather than redirect)?
>

If we had a permanent entry page to the documentation, such as
docs.haskell.org, that linked to the different kind of documentation (and
was attractive enough that people would link to it) that might help.

Johan
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.haskell.org/pipermail/haskell-cafe/attachments/20100722/15e36445/attachment.html


More information about the Haskell-Cafe mailing list