DEV Community

Why video tutorials should NOT replace reading documentation

Carl Wills on June 15, 2021

As more and more people start their programming journey, I'm finding that the number of video tutorials are increasing. That shouldn't be a surpris...
Collapse
 
jmfayard profile image
Jean-Michel πŸ•΅πŸ»β€β™‚οΈ Fayard

On the positive side, videos are better than the reference documentation to give you the big picture and a sense of familiarity.

On the other hand, it feels too passive to me. I'm following a video course right now and I sit uncomfortably in my chair, wanting to do something.

I wonder if programming videos are not the poor man's version of pair programming, one of the industry best kept secrets.

Collapse
 
carlmobiledev profile image
Carl Wills

There's definitely a place for video tutorials, but a healthy balance between them and documentation is what I've found is the sweet spot for my learning style.

Just like you said, they give you a great big picture overview and maybe a few keywords or ideas to lookup when you open up the documentation.

Collapse
 
siddharthshyniben profile image
Siddharth

I rarely watch video tutorials because they are too slow/too fast for me. I prefer reading (maybe a transcript of the tutorial)

Also, if a package is documented well enough, it's easy to learn. I learnt angular completely from the docs

Collapse
 
leob profile image
leob • Edited

Same for me, I vastly prefer reading docs or tuts over slogging through a Youtube vid!

Collapse
 
sandorfalot profile image
sandorfalot

I just can't do video tutorials for most things, in my former career in IT, to knitting, to what I do know, welding and machining. I prefer having my books with me. I cannot stand videos for coding at all, it just throws me off, unless its done very well. I don't learn well by video, but seeing someone typing code onto their monitor on a low res youtube video is just frustrating.

Give me the documentation any day. I also say this as someone who can't sit and watch a movie or TV show without doing something else with my hands. I knit or draw or something. When I was in college, we weren't taught by video. And my welding instructor is colour blind, he learned more by sound, which employers get a kick out of, too. I can hear your bad welding a mile away!

Collapse
 
carlmobiledev profile image
Carl Wills

Yes, totally agree. It takes someone with really good communication skills to keep me engaged and "entertained" enough to stick with it!

Collapse
 
leob profile image
leob • Edited

No you're not harsh at all, in fact this should be plain obvious to anyone ... and not only shouldn't video tutorials be replacing documentation, they should also not replace good ol' written tutorials (blog posts) !

Collapse
 
phantas0s profile image
Matthieu Cneude • Edited

I would go further than that.

At the beginning of my career, I was mostly looking for answers on Google.
Now, I'm mostly using the documentation. Why?

  1. It allows me to dig a bit deeper when I have a problem and to really understand what happens. I learn wayyy more that way.
  2. Documentation is way more reliable than the random stuff on Internet (including stack overflow).

But it's a question of preference and also depends where you are in your career. For beginners, some documentation is too complicated to understand and ask for too much prior knowledge.

Sometimes, it's also good to look at a video when you're only mildly interested by the subject or because you know that you remember things better that way.

In short and as always: "it depends". Of the context, your personal preferences, and what you're trying to do.

Collapse
 
carlmobiledev profile image
Carl Wills

Yeah, so true! Sometimes video or stack overflow can be really helpful, but the documentation never lies!

Collapse
 
Sloan, the sloth mascot
Comment deleted
Collapse
 
arif98741 profile image
Ariful Islam

yes official documentation is always recommended

Collapse
 
jdeepd profile image
JDeep

Ya. Even a book is more useful than Video tutorials. I find books to be way more helpful in clearing concepts. I watched a ton of videos on how to use git but I only learned to commit , push and pull(And honestly I thought that was everything in git) until I read the book Pro Git. When reading the book, I realised how so many important things were just completely ignored in the video tutorials.

Collapse
 
jonahhgohh profile image
Jonah Goh

Great post! Really agree with you on this one.
I'm still fairly early in my programming journey and I started mostly by going through video tutorials. I used to learn almost everything through videos on youtube because I felt documentation pages are really wordy, hard to understand and I generally took a long time to find for the information I need. I was so dependent on learning through videos that I used to search for answers of my code on youtube, so that I could follow along. Looking back it, that was quite stupid of me haha.

A while back, I started making documentation as my go to and it is life changing.. I started getting things done so much faster than before. That 10 minutes of video I put myself through, I learn so much more and in depth just by reading the documentation in that same amount of time.

Now, I mostly watch videos only if I am learning something completely new and I want a big picture of it or if I need more clarifications from the documentation I do not quite understand.

Collapse
 
carlmobiledev profile image
Carl Wills

Awesome! I'm glad you found the right combination for your learning style! I'm the same way, I like videos for big picture stuff but I always seem to dig into the documentation to figure out what other options I have, or other things the videos didn't go over.

Collapse
 
abdulrahmanelheyb profile image
Abdulrahman Elheyb

I currently learning about the redux to use with nextjs application but I started to watch videos tutorials on youtube I realized that is some videos do not give all property or needs, of course, it gives basics but the features are coming every month, I recommend watching updated videos have a recently uploaded 5 month or 1 year ago.

Sorry for my English grammar I keep learning by type the more.

Collapse
 
milandry profile image
Michael Landry

Great documentation > great video tutorials > bad video tutorials > bad documentation