Video tutorials?

Video tutorials are great for things like preparing your development environment, or using an animated slideshow to explain complex concepts like the Data API or mixin processing. Not so much actual programming. Here’s why.

First of all, with textual documentation, you can be much more concise with your example code, or even not provide any, which forces people to understand what you’re talking about before using it. However, with a video tutorial, full functional code is used at all times, greatly enabling cargo cult programming.

Second, documentation will always be out of date eventually, and it is one of those ways that the universe functions that videos of programming will always be out of date no matter how hard you try. Even barring that, however, if one uses textual documentation, then updating it is as simple as writing the new bits and committing it, whereas with video documentation the entire video must be re-recorded every time something changes. And no matter how updated you keep your videos, unless you directly delete the old ones (and even then, because of reupload trolls), you will always find people using the outdated videos.

Back in 2012, a channel called BcBroz uploaded a massive tutorial series on Bukkit pluginmaking. I haven’t seen anything beyond episode 4, but what I did see was several years out of date. And hundreds of noobs, incapable of looking for the link labeled ‘Wiki’, would search YouTube for how to make a Bukkit plugin, and BcBroz videos would appear at the top of the list. And forevermore, countless people have been posting in the Plugin Development section with enable/disable log messages, using Minecraft’s logger instead of their plugin’s, with command functions that don’t check before casting CommandSender to Player, compare aliases instead of command names, and return false no matter what. And then every comment tells them to stop watching video series and read the perfectly good documentation.

Just sayin’.
Also, OBS is the best IMO. There might be better premium software somewhere, but OBS is also free.

3 Likes