Why am I sharing my travel stories?
Founder & CEO of TruStory. I have a passion for understanding things at a fundamental level and sharing it as clearly as possible.
I’m amazed how quickly the last four weeks at Hack Reactor flew by! Here’s an updated diagram of what I’ve learned:
As you can see, the past segment was definitely meaty. Yet it was my favorite week of the program thus far. Why? Because Node.js is seriously awesome! I’m really enjoying the process of thinking about and building the server-side of an application. I’m eager to use Node.js and share some of my learnings. Future posts to come!
As I learn more advanced technologies like Node.js and Sequelize, one of the most useful skill sets I’ve built is reading and understanding documentation. So for this week, I’d like to talk about my personal experience as a newcomer with documentation.
Documentation can be incredibly scary for newcomers. It certainly was for me — I avoided docs like the plague. I was frustrated by the difficult jargon and overwhelmed by all the new concepts. Like many newcomers, I relied on blog posts and tutorials to walk me through issues, only cracking open the documentation when truly desperate.
For better or worse, I couldn’t hide from documentation forever. For one, the scope of most blog posts and tutorials is narrow, which left me with an incomplete understanding of what I needed to know. Secondly, as I started to build more complex things, my needs became more specific and interdependent. Something had to change. So I resolved to train myself on reading documentation, and to stop bypassing documentation in favor of blogs.
And wow — it was a rough learning curve. Figuring out what they were trying to tell me meant going line by line, stopping at each unfamiliar word. Over time, I learned the conventions and it got easier. Documentation isn’t scary anymore — in fact, it’s now the first place I go.
Of course, I’m not suggesting anybody neglect other resources like Stackoverflow and blog posts. They can be awesome for some problems. But I’d argue that as a developer you’re expected to be able to read and understand the documentation for technologies you’re attempting to use. Otherwise, it’s like going through life not knowing how to read. Not impossible, but ridiculously inconvenient.
Learning how to tackle documentation probably sounds scary for newcomers, especially given the fact that it’s often so poorly written. But don’t fret — anything is learnable with honest effort.
Here are a few quick tips for anyone who’s new to programming and finds documentation intimidating: