4 ms·
This is such an important topic. What I do when learning something new is create a Word or vim file to document my own learning process, filling in the gaps lef
by pmdulaney 6y ago
This is such an important topic. What I do when learning something new is create a Word or vim file to document my own learning process, filling in the gaps left by the tutorial as I go. That document becomes my own personal tutorial.
People who write tutorials will counter: "You can't teach EVERYTHING -- you have to assume some knowledge!" Which is true, which any parent who has endured an infinite chain of "why" questions from a child can attest. But most online tutorials could be MUCH better than they are.
I've come to the conclusion that the reason most tutorials are so bad is because -- unlike myself -- most people who write tutorials don't like teaching. They think it is a distraction which takes them away from their "real" work. But I would challenge those who write tutorials: Create a work of art! Good documentation is something to be proud of.
- taphangum 6y agoAmazing comment, and I totally agree! I am actually one of those people who never used to like making tutorials. What changed my mind ultimately was gaining an understanding of just how impactful they could be. Good documented can indeed be a work of art, and is the first port of call for anyone who'd like to engage with your technology. Why would you not want to take that seriously?