search

haskell-infra / hl

Haskell web site (old -- see new repo at https://github.com/haskell-infra/www.haskell.org)
http://haskell.org/
BSD 3-Clause "New" or "Revised" License
158 stars 92 forks source link

Order of the sections of the documentation page #131

Open duplode opened 9 years ago

duplode commented 9 years ago

This /r/haskell thread made me notice that it is a little unintuitive that the links to Hackage and other API references are near the bottom of the documentation page. I'm not sending a PR because I don't know the rationale for the current order (and it does make sense to have books and courses, the resources most useful for beginners, near the top).

gbaz commented 9 years ago

This is a good idea. We should definitely think about improving the organization, but I agree I am not clear on the correct order :-).

zimurgh commented 8 years ago

What they need is some basic annotations to explain the utility of each resource. Some are self-explanatory (like Simon's book on parallelism), but there's a ton of "Learn Haskell!" links on the page and they need to be clearly summarized with some kind of annotation so potential readers can decide which resource is actually relevant to them.

I'm currently prepping a PR for haskell-lang that addresses this very issue, but I can shuttle the relevant changes here as well.