DEV Community

Do you prefer video or written coding tutorials?

Suzanne Aitchison on December 12, 2019

I've been posting here for a little while, and maintain some tutorials over at my site Up Your A11y, but so far it's all written content. I'm toyi...
Collapse
 
loiclemerlus profile image
LoicLM

I actually prefer written tutorial as it allows me to learn at my pace rather than at the speed of the video. Learning coding usually involve a lot of back and forth and it is better for me in a written format.
Video can also be good for showing interactivity or results. In which case I like embedded videos.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

I hadn't considered just embedding short clips - great idea!

Collapse
 
tiguchi profile image
Thomas Werner

I prefer written tutorials for the reasons other people have stated. However, if the topic is amusing, interesting or entertaining then I also enjoy it as a video. For example The Coding Train, 3Blue1Brown or something like this video by the Engineer Man. But I usually watch that stuff just out of curiosity or for entertainment, not to so much to purposefully learn something new. That happens more as a side effect

Collapse
 
s_aitchison profile image
Suzanne Aitchison

That's really interesting - thank you for sharing! And thanks for those references - I'll have a watch 😁

Collapse
 
tiguchi profile image
Thomas Werner

Let us know when you upload your first video!

Collapse
 
papabearcodes profile image
David Quick

My preference leans more towards written. I feel as if reading a tutorial helps with keeping at your own pace and allows the reader to do more research and reference. Following along with a video can subconsciously hold you in this weird place (tutorial purgatory) where you're just looking and listening, but not necessarily absorbing.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

I think I identify with that too - I'm pretty sure I drift away more easily from videos than written word. Some people must find the opposite I'd imagine 🤔

Collapse
 
papabearcodes profile image
David Quick

100%. It's all about preference. I never used to like written articles and I would cringe when I saw lengthy ones, but it was something I learned to love.

Collapse
 
osirisgothra profile image
Gabriel Thomas Sharp

Poke poke, here have a recent answer from someone you don't even know: I like written tutorial, and also on occasion I like written tutorials, and did I mention written tutorials? There are far too many bloated, cannot-find-the-gist-of-it, hard-to-understand-that-persons-voice, poorly-structured, way-too-long-introduction, ended-up-not-even-having-what-I-was-looking-for video tutorials out there!! On the flipside, a well-made video could save time, however, the ratio of good:bad is like 2:98, which cancels out that one pro :( I hope that was clear enough to understand :) (oh I was writing, so you probably did hahah!!)

Collapse
 
paradoxinversion profile image
Jedai Saboteur • Edited

I prefer written tutorials, largely because I can read faster than I can follow along in real time (or sped up). I don't dislike them, but if I have an option to scan something 'on a page' rather than scrub through time and listen for what it is I may be looking for, I'll take that option.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Yeah I think I tend towards the same, and it's interesting to hear I'm not alone in that!

I see so many video tutorials out there and I really want to provide info in the medium people find it useful, which is what made me wonder if I should start doing more videos!

Collapse
 
seanmclem profile image
Seanmclem

With videos I'm often pausing, going back, and zooming-in. I prefer written tutorials. I usually only like videos for opinion pieces or comparisons. I probably watch 1 video for every 25-50 articles I read

Collapse
 
manuelojeda profile image
Manuel Ojeda

Both.
Depends of the context. Sometimes I can read fast enough and follow the right flow of the code, but sometimes too I need to watch a video to teach myself and avoid any kind of error that could happened to be.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

So maybe it could be an idea to have a written tutorial, but with a link to a video you can go to if you decide you'd rather see a walkthrough?

Collapse
 
manuelojeda profile image
Manuel Ojeda

Exactly, I like having both options at my disposal. Also, a lot of people prefers consuming a tutorial through a video instead reading.

Collapse
 
darthknoppix profile image
Seth Corker

I like video content and articles. Depends on the topic or my mode of thinking at the time. You're written stuff is great!

If you're going to make some videos, it would be cool (and meta) to explore how video and audio can be more accessible on the web.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Ooh yes I like that idea - and I think there is a lot to be said about it!

I think my main driver for considering translating some stuff to video (other than seeing some people seem to engage with video content) is being able to show recordings of screen reader usage/keyboard navigation etc. But there are other ways this could be done like smaller embedded videos 🤔

Collapse
 
darthknoppix profile image
Seth Corker

I’ve experimented with adding small embedded videos that work quite well (around 10 - 20 seconds).

I think it would be great to show screen reader etc. It’s something that can be communicated over video much more easily and is more engaging like you said. Go for it!

Collapse
 
tam360 profile image
Mirza

I used to follow video based tutorials but now I prefer written ones. "Tutorial Hell" in the form of videos is really annoying as they're slow and don't cover the advanced concepts (which basically are the main bottlenecks for learning pretty much anything).

Now, I am trying to make a habit of reading official documentations as much as possible (followed by stackoverflow/other coding forums and blogs) in order to understand. The only dev related videos I watch are online webinars like Goto Conferences

On a side note, I feel like documentation is the real underdog of whole software engineering process. A good documentation such as those of VueJS/Laravel/RoR can provide more clarity and save hundreds of hours if not more (if read properly). But it doesn't get appreciated by engineers most of the time, sadly.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Documentation is key! I actually just listened to a really good episode of the React Podcast where Rachel Nabors spoke about this - definitely recommend if you haven't heard it yet 😀

Collapse
 
tam360 profile image
Mirza

Will definitely try listening to them!

Collapse
 
ascaliko profile image
Ascaliko

I think it depends on the people, because that person in learning has his own characteristics where there are three characteristics namely Visual, Auditory, Kinesthetic. so for me, and my character is kinesthetic and visual

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Yes that's my thinking totally - I want to make learning about accessibility as easy for people as possible, which would include offering different versions of the same guidance so that more people's learning style is catered for

Collapse
 
jhall profile image
Jonathan Hall

You can also do both on the same topic, if you wish, and link to each other. I've done this a couple of times:

Collapse
 
s_aitchison profile image
Suzanne Aitchison

This is what I was thinking of doing! Just to give people the choice 😀

Thanks for sharing those examples!

Collapse
 
kaykleinvogel profile image
Kay Kleinvogel • Edited

Im actually loving both formats and use them both.
I'll usually start with a written tutorial and work with it. If I'm hitting a roadblock or want to see how others are doing it I'll then switch over to videos.

Videos in my experience have a more personal touch. The creator is more likely to share some personal story when he's doing a video so this is good way to see another perspective.
Text based tutorials on the other hand are more likely to focus on the task which is nice if that's what you want to focus on.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

The creator is more likely to share some personal story when he's doing it so this is good way to see another perspective.

I think that's a great point. There's an opportunity with video to add value with more nuanced personal perspective, which wouldn't really work with written tutorials

Collapse
 
admodev profile image
Adolfo Moyano

Both, the only thing that i think it ruins a tutorial is showing the code at the very first of the tutorial or while you explain it, the code snippets have to go at the very end of the tutorial, that's the best way to learn, but if i have to choose one i prefer written tutorials because i can go at my own pace.

Collapse
 
bahadirbalban profile image
Bahadir Balban • Edited

Very interested in this subject and surprised to see a lot of people prefer written tutorials. I think written works best if there are step by step instructions (e.g. commands to run), and video if you need to really learn a subject. I am a fan of video and I am very picky about the video format. It must be already zooming to code, explain only one concept at a time, be free of sentences that don’t improve your understanding, clear of words that don’t add meaning (actually, um, really, possibly), not be slow paced,- every second counts, should go in depth. Here is my tutorial where I tried to adhere to these rules (became #2 nodejs video on freeCodecamp) getbuzz.io/c/learning-expressjs

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Thanks for the link - I'll have a look! I think the general consensus seems to be that, like you say, thought and care needs to go into making videos concise and clear, otherwise they end up just being a frustration! Definitely good to have some examples to look at 😁

Collapse
 
joerter profile image
John Oerter

It's hard for me to say, because I think both are great. If it's something very detailed that I need to follow step by step, then I prefer written tutorials. For more topical tutorials on things I'm just learning about, I prefer video.

I took a look at your site, and really enjoyed the content! I'm going to apply some of the tools I picked up to my own site. There is definitely more room for quality accessibility tutorials.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

I'm so glad you found some of the content useful!

That's really interesting insight 🤔 I hadn't considered that maybe some more high-level intro/overview type content might work better as video. Great good for thought - thank you!

Collapse
 
tails128 profile image
Tails128

It really depends on the subject... in an ideal world both of course! (like: a video with an article), but otherwise video if I am learning a new approach/framework and article if I am learning something small or if I am hunting for new stuff to learn.

I feel like I have no preferences between video or article, the real deal breaker for me is to have the project included in a link, so that if something is not working I can double check!

Collapse
 
devvyd profile image
Dāvis Naglis • Edited

As a lot of concepts, it depends - I certainly prefer video tutorials as it it most cases include some examples with explanations on-the-go, last resort would be written tutorials/documentations, but they are not great everywhere and a lot of times lack different use cases / examples.

Collapse
 
courtneypure profile image
C. Pure

I’m a visual learner so I love video tutorials. I think my only pet peeve is when videos don’t show real world applications to what they are trying to teach. I want to excited about learning something new and at the possibility of using it!

Collapse
 
galoiswannabe profile image
galoisWannaBe

If I can follow the written tutorials, then that, but for things that just don't make any sense to me, I go with the videos to clear them up.

Video tutorials are usually more than just a quick one-off example, so they often allow me to better adapt the thing to what I'm trying to do.

But they also take longer, as I can't just scroll to the most relevant example and kinda poke at it to get it working.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Yeah I guess you lose the "skin and scan" that you get with written... Which like you say might not be a bad thing if the content benefits a more detailed look 👀

Collapse
 
jhall profile image
Jonathan Hall

I almost always prefer written, but there are some times where a video makes more sense, I think.

When the thing you're teaching is just a list of easily defined steps, written makes more sense to me. Example: "How to install the latest version of node.js" or "How to proper do error handling in Go"

When the think you're teaching is a process with no defined steps, then a video can make more sense. Example: "How to do Test-Driven Development" or "How to conduct a brainstorming session with your team"

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Yeah you're right, the less defined the steps (and actually the more debugging someone might need to do as they're following along), the more helpful a video could be.

Collapse
 
andrewbrown profile image
Andrew Brown 🇨🇦 • Edited

I like content that is to the point. It can be drag scrubbing through a video or wading through text.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Good point! I have a feeling that a good, succinct, video tutorial will need quite a lot of careful planning and editing...

Collapse
 
andrewbrown profile image
Andrew Brown 🇨🇦 • Edited

It depends on the nature of the video but for me, it's not the case and I churn videos out rapidly. I find the sooner you get in front of a camera the sooner you experience the flow of the educational content which leads to faster iteration and then I transcribe my videos into the content.

Many seem to struggle with video, some form of analysis paralysis.

Collapse
 
default profile image
default

Written. Always. Written content is so much easier to skim and digest at your own pace. Don't have time (patience!) for video tutorials.

Collapse
 
rafed123 profile image
Rafed Muhammad Yasir

Maybe most of the people in the comment section prefers written tutorials because the video watchers aren't here. :P
I prefer written content too.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Haha ummmm yep, excellent point!

Collapse
 
ferricoxide profile image
Thomas H Jones II

Hate, hate, hate, hate, hate video-based training of pretty much any sort. The pace is never right (and that's usually the least-notable problem with video presentations).

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Definitely seems there's a lot of folks videos just don't work for!

Collapse
 
johnmunroengica profile image
John Munro

video for overview and basic understanding of concepts

written for in-depth and for tutorials to follow

Collapse
 
fandisus profile image
Fandi Susanto

You can not ctrl+F on videos.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

This is very true. Someone made the point earlier in the thread that maybe a way to improve this is to have a transcript on the same page and clear video time points for each section. So potentially you could just read as normal but skip to the relevant video section if you wanted to see it in practice 🤔

Collapse
 
juancarlospaco profile image
Juan Carlos

Both > Written > Video

Collapse
 
mochagungh profile image
Moch Agung Hermawan

written, i think

Collapse
 
johnsoncherian profile image
Johnson

I go for video tutorials divided into small sections with maximum duration of 10mins. This helps me to watch the tutorial first and then practice them part by part.

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Yeah I think length is key. Ten minutes seems like a good amount of time

Collapse
 
itachiuchiha profile image
Itachi Uchiha

I prefer written coding tutorials but I also love video coding tutorials.

Collapse
 
peterklein profile image
Peter Klein • Edited

I Like both, Video and written. But i think often the learning is faster and better when i watch a Video tutorial.

Collapse
 
vzuburlis profile image
Vasilis Zoumpourlis

For just code I prefer it written. But when it is focused on styling I would enjoy it better in video.

Collapse
 
pinotattari profile image
Riccardo Bernardini

Written, written, written. No doubt about it. Videos are waaaaaaaaaaaaaaay too slow (not to mention the audio quality of some videos)

Collapse
 
anjankant profile image
Anjan Kant

I used both Video and written Tutorial

Collapse
 
s_aitchison profile image
Suzanne Aitchison

Hmm that's a good point. do you know any free (to users and creators) platforms that are good for these kind of videos?