The docs have gotten a lot better. In particular, the guides site has a lot of really useful content:
You will probably still have to look at the API docs (and read some source) from time to time, but the core team is taking documentation a lot more seriously now.