Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Order of the sections of the documentation page #131

Open
duplode opened this issue Sep 4, 2015 · 2 comments
Open

Order of the sections of the documentation page #131

duplode opened this issue Sep 4, 2015 · 2 comments

Comments

@duplode
Copy link

duplode commented Sep 4, 2015

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
Copy link

gbaz commented Sep 8, 2015

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
Copy link

zimurgh commented Apr 28, 2016

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants