@tomjaguarpaw @Kleidukos Re Documentation, I really like the idea of having a canonical documentation page to orient people when getting started. Here are some of my own thoughts on what could be improvements. (You’ve probably thought about this much more carefully than me, so please feel free to disregard if these seem silly, or addressing the wrong issues).
The page is currently divided into sections like Courses, Tutorials, etc, which are useful, but potentially overwhelming to a beginner. An alternative layout would be to have the page divided into Beginner resources and Intermediate ones. I also think it would be nice to have fewer links (or rather, a few links that are emphasized, and the rest shown optionally), and more generally to have a clear single narrative of what they should do to get started. Here’s a rough draft of what I’m thinking:
Resources for Newcomers
CIS194: (brief description, link)
Other courses (click to display)
Learn You a Haskell is a community favorite. There’s also an interactive version
Other books (click to display)
How to set up HLS with VSCode.
Something like Haskeleton that shows how to set up a new Haskell project (introducing stack/cabal on route)
A single link to a nice explanation of Hackage, Haddock (focusing on how to read docs)
A single link to an explanation of Hoogle, with a nice example (perhaps recommending the VSCode hoogle extension)
Resources for Intermediate Haskellers
A detailed survey of important language concepts and features: (link to What I Wish I Knew When I Learned Haskell)
What libraries should I use?
Online resource: State of the ecosystem: post-rfc/sotu.md at main · Gabriel439/post-rfc · GitHub
Book: Haskell (Almost) Standard Libraries
Parallel and Concurrent Haskell
Developing Web Applications with Haskell and Yesod
I think endorsing VSCode with HLS is a great way to make Haskell more beginner friendly. Of course, other tooling options could be mentioned, but I think this one should be highlighted.
The one other thing is that a huge part of how I learned Haskell is from blog posts. It would be nice to have some kind of overview of community-endorsed good blog articles, or a monthly chosen article to highlight. Something like the following could go on the documentation page: “Haskell has a rich user. Here are some examples of blog posts about Haskell concepts and their applications (links…).”
Finally, it would be nice if this documentation page was linked more prominently from the front page.
tldr: I feel like less is more when it comes to pages like this, even at the risk of dropping potentially useful info.