Some initial thoughts on what I think would be good to see when visiting haskell.org, starting with the home page. I appreciate that some of these things require significant effort, but not all:
Benefits advocated over features. I don’t think we should assume visitors know the benefits of, for example, the Statically Typed feature. What if they are a business decision maker, or newer to development? Start with a benefit, reveal how Haskell delivers it, and expand on click to feed those hungry for details.
Videos curated for adoption purposes. The videos are great, but are they increasing adoption? The list feels quite static, but when it changes, I think some motivational/on-ramp content would be good (along with knowing at a glance which they are).
In general, the homepage should appear updated recently, even if it’s just version updates. And a first eyeful has those videos, but if they aren’t driving adoption, it might be better to move benefits up there. Answer “Why Haskell?” at first glance. I think the homepage should be an all-out adoption funnel for newcomers, dev and biz alike.
For the Get started page:
Really like the introductory tour idea of @jazzlobster.
Still would like an equivalent of the Rust Book. It isn’t perfect, and does too much sometimes, but it’s free online and a more accessible read than many Rust books out there. I think Haskell could go far with less, paying attention to pacing, showing how to achieve practical wins, and correcting errata.
Haskell by Example. I think getting straight to examples without installation is great when people want more of a taster before installing locally, and do like “Try it!” on the home page.
There’s too much text in my opinion, and I’d like to see jumping off points generally, unless “first steps” can be brought concisely inline.
I’d like to mention the learning path overall:
A problem affecting many interesting subjects is the “curse of knowledge”. Smart generous people wish to pass on their knowledge, but it isn’t always at a pace that others can consume. I think there is a place for Haskell.org to help smooth out and direct the learning path, with early educational assets the community has involvement in, and advice about how to progress through to jobbing intermediate level.