Follow

In the holy name of Cthulhu, stop doing video tutorials!

They are useless, do not allow you to go in depth on a subject, and, unless your production values are top notch (read professional sound and image crew) will probably be horrible and a pain to watch.

If you care about a technical subject, please take the time to *write* about it and publish it on the Internet.

@ParadeGrotesque

They are good if the written language is not your strongest language (ie written documentation is English and English is not your main working language, for example). It is also good for people that are more like visual learners, or even kinetic learners, or even want audio learning.

(I'm assuming that you don't include conference videos, which may include tutorials and we are probably not talking about stuff like Dr. Messer videos?)

@ParadeGrotesque It's interesting because one of the first places I go to when I am learning something is.. a video tutorial source and I generally don't care who does it. Also the highly polished 'tutorials' are most likely vendor marketing oriented type videos or it's by an education provider in which case one is paying hundreds or thousands for the course.

@superruserr @ParadeGrotesque

I always prefer written material in *any* language (and I'm not native English, take note), because written text is so much easier to read and reread until it's understood. And written material is so much easier to use as reference later on. May be an autistic trait too.

If there's no written material available, I may as well not use the thing I'm trying to use. Video tutorials are useless for me. I'm very sad of the recent trend to make *only* video.

@Stoori @ParadeGrotesque

It's different for people. I didn't mention that they should replace written materials though, in fact I think written materials should be first priority.

@Stoori @ParadeGrotesque

Also there is most definitely an audience for video tutorials since there is a large number of resources that implement video - Pluralsight, LinkedIn Learning (formerly Lynda), just one video of Professor Messer's CompTIA can have 230k views. MSFT Word tutorial has 15million views. Depends on software/theme also.
From a vendor perspective (so not relevant to most people reading), being in YouTube search gives vendors a slight edge over search engines w/ getting 'found'

@superruserr @ParadeGrotesque sure, I don't mind there being videos. But what makes me annoyed is the trend to make just the video and not give any textual instructions.

@Stoori @ParadeGrotesque

There is a chance it is more like a marketing oriented video and for various reasons they avoid documentation.

I used to work for a SaaS that basically did not want to post any documentation because the logic behind it was that if you needed documentation for this product, the software UX/etc was bad. Plus the 'app' would update so even though there was a Support team they would rather not have them spend it on updating over documentation.

@Stoori @ParadeGrotesque Another reason why there is little documentation is that they want to have documentation as part of 'paid support'. Or the only person willing to do documentation will only do videos (sometimes it is a major pain starting written documentation) or they have no one to write it.

If you use and especially pay for the product it is worthwhile bringing it up to them directly. I once started a new project where they recently got rid of the written documentation..

@ParadeGrotesque Totallly agree but people are obviously hoping for some of that elusive YouTube advertising money.

@ParadeGrotesque In most cases what you write is truth. My problem with video tutorials is how the presenter sounds. If they are unclear, have thick accents, are hard to listen to, aren't using a script (rambling, repeats), or have some vocal 'tics' like upspeak I can't get into them.
One person presented a Python YT tutorial but she sounded like this? Every sentence? She was hard to listen to? I gave up after the fifth sentence?

@ParadeGrotesque yeah

For me it’s the static bitrate. When I’m reading I can speed-up or slow-down the information dynamically and the net result is getting the information I need much faster.

I’m not opposed to videos as an option, but when it’s the only form, that sucks 😁

@ParadeGrotesque IMO, this goes beyond tutorials.

Don't bother with audio and video when plain text and a few carefully chosen images will do.

@ParadeGrotesque There are situations where video is the right tool. When what you want to know is, say, how to disassemble something, or how to set up a machine tool, it can be far better than any amount of text. I see it used, however, FAR beyond any sane context.
Put me down in the column of those who become frustrated without the option to assimilate information at their own speed, & skip back & forth at will.

@publius @ParadeGrotesque

One technique I’ve seen is to embed short (animated) GIFs in a written tutorial. That gives you the advantages of text while still being able to show key things as little videos.

@suetanvil

That's a good point. Recording a terminal has become easier recently, and it can be interesting.

@publius

@ParadeGrotesque idk... I personally prefer written tutorials for many things, but video works better for other people. Not all of us learn the same way.

@ParadeGrotesque 100000% agree except that I'll admit that as long as it's accompanied by a full text description, a short video that explains, for example, how to get a tricky part in place can be justified.

@ParadeGrotesque Many of the younger people at work couldn't live without video tutorials, and think that written documentation is horrible.

For me it's the other way round. Video and audio blocks my mind, and I can't think while watching. With text, I can take my time, skip back and forth, look something up in parallel, quickly try out an example - whatever. I try to avoid vendors who only supply video, but it is getting harder. Good technical writers are expensive.

@ParadeGrotesque Absolutely agree, there's nothing more useless than video tutorial.

@ParadeGrotesque @Digitalcourage i'd say it always depends on the subject. I like scientific stuff in videos (like explaining equations by gradually developing them). But i prefer tech stuff in written form (and optional screenshots if necessary). Recordings of someone configuring something are tiring to watch.

@aslmx @ParadeGrotesque @Digitalcourage

with electronics/electrical engineering I find that *demonstration* videos work better, ranging from things that you might aspire to do but currently don't have the resources/knowledge (such as restoring a 1960s radio) or being shown why you *don't* want to do a thing (i.e using cheap/defective equipment on 230V mains that short circuits/overheats). You do learn stuff from them but they are used alongside things like forums, blog posts etc..

@ParadeGrotesque @Digitalcourage No, please don't stop doing video tutorials. There are good ones and there are bad ones. I love them both. It's great to see someone hacking Linux or disassembling a laptop, smartphone or anything. But please use peertube to publish your tutorials. That would be great. Thank you. Roll it! 😎🎬📹

joinpeertube.org

@ParadeGrotesque If you mean a specific subject you don't like videos on, just say that (programming maybe?)

Otherwise, video tutorials are great! for visual/sensory learners and for things that are hard to describe in writing & better to demonstrate.
- how to repair cars, appliances, home systems, computers, etc.
- how to build/make things
- how to play an instrument or a certain song on it.
- how to do physical things like sports, etc.
- demonstrating operation of machinery or software

@leadore
You have a point: for certain technical subject (assemble or disassemble hardware, music, etc) a short, on point, video with good production value may be more efficient than a text.

On the other hand, so many video tutorials are atrocious rambling nonsense it's hard to for me to pay attention.

My point still stands, though: it's worth taking the time to *write* what you'd like your video to be about. Before shooting it.

@ParadeGrotesque

"stop doing written tutorials!

They are useless, do not allow you to go in depth on a subject, and, unless your writing skills are top notch (read professional style and content editor) will probably be horrible and a pain to read." /s

seriously though, don't friggin discourage content creators who are trying to share about stuff they care about, or who are trying to give back to the community.

@cpb

You have a point, in the sense that I should not discourage people from sharing knowledge, and I apologize if my wording was perhaps too harsh.

My main point is this: video can be interesting in some cases, but it should be kept short. Writing something that is detailed and on point is almost always better than video (IMHO).

I have found some (very) valuable information even in poorly written documentation.

@ParadeGrotesque
Also, they're neither searchable nor translatable and you can't just skim through to the part you came looking for. They don't work for people with aural impairments either. I hate this trend.

@ParadeGrotesque I've learned welding (to some degree) by watching video tutorials. Cannot imagine getting to the same point so fast by studying written instructions.

@ParadeGrotesque

I have to disagree about that. Sometimes you can write 1000 words to desribe something and nobody but you will understand the content, show them a picture and everything is clear. In my company I have to write a lot of workinstructions. Sometimes you just to forget to write a certain part down which is necessary, because it is "basic". A Video just contains everything even the parts you "forgot".

@ParadeGrotesque I wonder what this toot would have sounded like in the time of King Hammurabi.

"In the holy name of Marbuk, stop doing written tutorials! They are useless, don't allow interaction with your apprentices, and, unless your slabs are top-notch, will probably be horrible and a pain to read."

"If I see anyone writing a tutorial, I will cut off your chiselling hand."

@branko

To be perfectly honest, if all our written documentation looked like this... I could sypathize with the feelings! 🤣

en.wikipedia.org/wiki/Cuneifor

Sign in to participate in the conversation
Mastodon @ SDF

"I appreciate SDF but it's a general-purpose server and the name doesn't make it obvious that it's about art." - Eugen Rochko