All You Need to Know about Tech Tutorials

All You Need to Know about Tech Tutorials

People often ask me how I write tech tutorials. I’ve given partial answers time and time again, but I wanted to cover it all at once so that you know what I typically put into a tutorial and how you can plan one out.

To date, I’ve written over 60 free tutorials, recorded many free videos, and over 100 videos for my various courses. So I’ve got some experience.

And before you say that “this isn’t for me” — we’ve all got something unique to share so please don’t think you can’t do it, no matter how junior you may be! I started writing tutorials as a way to better understand what I was doing day to day in my job.

Choosing the Topic

  1. “Docendo discimus” (by teaching, we learn) — if I’m learning something new and I want to understand it fully I try to teach it. This makes me go through code line-by-line and explain it.
  2. I use something, and it helps me — maybe it’s push notifications, maybe it’s Meteor + React Native. If I use something and I think others could also use it, I share that knowledge.
  3. I’m asked about something. I receive 50+ tech related emails a week. If a question comes up a lot, I write a tutorial about it.

The Code

Write the code first.

Planning the Tutorial

If I’m recording a video, I’ll put together a “shot list” which is just a series of shots I want to record. A section will have anywhere from 5 to 15 shots. This helps me record the video in short segments, allowing me to re-record segments when I make mistakes, and edit it all together later on.

I’ll typically form my outline in the following way:

  1. Take my code example and comment out everything directly related to the concept I’m trying to teach
  2. Create a repo/branch with the starting point of the code for the tutorial
  3. Uncomment pieces of code in related segments, making my sections. My goal is that every section can be run on its own.
  4. Make a repo/branch with the finished code

A note on the starting point: Think about your target audience. What do they already know? Don’t worry about basic setup if you’re targeting an intermediate/advanced audience. Just give them code that works and if they want to know all the details they can read the code over.


Leave a Reply

Your email address will not be published. Required fields are marked *