The core language docs are ok. --> If you know Haskell!

The architecture docs are ok. --> If you already understand the concept and are willing to read some other tutorials.

The effects docs are... no comment.

Compare the guide to others like from Rust.

A lot of people I've pointed to Elm gave up quickly because there s no good introduction guide. It's not even properly linked as a first, visible entry in on the docs page.

The documentation for Effect Managers is basically "If you don't already know how to make one, you shouldn't be making one." I get that it's an "expert feature", but I want to learn and try anyways! I've been learning the basics by looking at the WebSocket library, and reading the compiler errors when I broke it in different ways. The compilers errors were surprisingly helpful, but some documentation would be nice.