Embed Notice

@saper
Working with new devs a lot, I can confirm that they don’t always reach for docs — in large part because they don’t know •how• to.

Part of that is their learning: figuring out how to be good readers, good searchers, good investigators.

A lot of it is the failing of the docs, which frequently take the POV of tool experts and tool authors, and utterly fail to understand what newcomers need. A hermetically sealed maze with no front door.