This post was originally published on my blog.
I was driving on the highway a few days ago and thought of something interesting. Somehow I found similarity between road signs and writing tutorials for beginners. Let me elaborate.
Say you’re driving on the highway. While doing so, you pass by all kinds of road signs. One that comes quite often is the speed limit. It servers two main purposes. One is to remind YOU - the driver already on the highway - what the currently lawful speed limit is. It’s not that you forgot about it. After all, you saw it just a few minutes ago. But seeing it again confirms an information you already have.
Its second purpose is to give information to the new drivers that are merging onto the highway. They are joining from different roads and at different times, and they are just about to see the speed limit sign for the first time.
As for the person wanting to become a developer, this “getting started” tutorial will be the first opportunity to learn and get introduced to some new information. He/she is about to be joining an exciting new “highway” among many others already “driving” on it.
I admit that in the past I used to get annoyed by such tutorials. I was like “Oh, come on! Not another one! Please write something that will actually teach me something.” I’m sorry about that. I didn’t truly understand it back then. I see the point now.
So what’s the lesson?
Don’t dismiss “getting started” tutorials because you’re already familiar with the technology. Even if you don’t find it relevant, know that for someone somewhere this will be their first opportunity to learn something new. The least you could do is respect the time and effort put into it. Then share it with whomever needs it.