Documentation Is More Complex Than Tutorials

When someone tells you to "just read the docs," they're assuming documentation is like a nice tutorial with step-by-step instructions. Reality check: documentation is written by engineers who've already mastered the thing and assume you know what a "monad" is without explanation.

The LEGO analogy nails it. You want to attach a simple 1x4 brick to your project. The documentation? It's showing you how that brick can theoretically connect to seventeen different surfaces at impossible angles, none of which are the straightforward "just put it on top" approach you actually need.

Bonus points when the docs explain every edge case except the one basic use case that 99% of users need. Thanks, I really needed to know about the deprecated parameter from version 2.3 before learning how to initialize the library.