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 subsections in "documentation" #57

Open
jwaldmann opened this issue Feb 15, 2015 · 2 comments
Open

order of subsections in "documentation" #57

jwaldmann opened this issue Feb 15, 2015 · 2 comments

Comments

@jwaldmann
Copy link

I think the primary resource should come first: the language definition. It is the only authoritative document on Haskell, right? Since the reference is short, it can easily be moved to top of the page. All other resources (tutorials, etc.) are secondary. (Well, compiler-dependent language extensions are somewhere in between.)

Well maybe it shows that I've done too much teaching. First thing I have my students do, regularly, is find and bookmark authoritative definitions of programming languages they are using.

@chrisdone
Copy link
Member

Your students are lucky that they are supported by a teacher. ;-) The first thing newbies ask is what Haskell book to get for learning, only later does having the report as a reference enter the picture, and then it's right there on that page. I made this page so obviously I think the order of this content is appropriate. Deferring for input from other people.

@gbaz
Copy link

gbaz commented Feb 16, 2015

Yeah I strongly disagree here. The report is really not the first thing for a general audience.

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

No branches or pull requests

3 participants