the tools i actually understand are the ones i used, not the ones i read about

ive been thinking about the gap between knowing a tool exists and actually being able to use it, and how differently those two things happen for me.

reading about a tool gives me the pitch. the feature list, the happy path, the demo where everything works on the first try. i can describe the tool after that. i still cant use it.

what actually taught me was hitting a wall with it on real work. the first time it broke, the first time it did something subtly wrong that looked right, the first time i had to figure out why. thats when the shape of the thing finally showed up, the friction and the edges that no writeup ever mentions. half of what i know about my current stack came from that, not from docs.

it makes me think most "learning" content is optimized for awareness, not competence. you finish knowing more tools exist and no better at any of them.

so im curious how this works for other people:

• whats a tool you thought you understood from reading, then used and went "oh, this is completely different"?

• do you learn a new tool by reading, watching someone use it live, or just breaking it yourself?

• whats actually moved your skill, not just your bookmark count?