Fuck video “documentation” and write a goddamn user manual
@hastur fortunately my employer does have written documentation. This is just … every other thing in my life. Like “how to turn off the replace filter light on the microwave” does not need to be a 15 minute YouTube video
@susannah lol 😂
@susannah this is the worst in gaming; no one writes game guides anymore. the simplest question is only answerable by watching a 10 minute Youtube video ("like and subscribe!")
@nelson it’s so infuriating
@susannah It is better than no documentation, but usually is the other choice.
@susannah I think it arises from a pervasive Empty Vessel model of learning: the learner knows nothing, has no other demands on their time, and yet is deeply committed to becoming an expert in the subject. Video probably is a good medium for such learners, it’s just that they’re not typical.
@susannah oh dear gosh this so much. I do not learn via video at all. I hate it so so much.
And tutorials too please!
I always look in the youtube description for a text based link but often I'm disappointed...
Also my interest is strongly inversely proportional to the length of the video.
I feel like that's at least partially by design to get more click revenue...
@float13 @susannah I've never been in that scene, is this kind of thing how it's done? I don't actually know what dictates how much money a video creator makes, is it an ad thing?
I can see it for things that are super linear (like lectures) or very visual (like making pottery) but there's just so much that is low effort and low information.
I don't know how the money thing works either; I should have said "views".
But yeah some things deserve a video tutorial, but 99% of the time I just want a TL;DR written tutorial, and a video as last resort if it's *really* that complicated.
I'm trying to learn FreeCad right now and the tutorials are all over the place.
@susannah Both if possible, since different people learn best in different ways.
@renvixn Mostly a myth https://poorvucenter.yale.edu/LearningStylesMyth
@susannah True. Fuck corporate bullshit.
That aside, some people do find videos better, or a mix. I personally like both.
I at least prefer pictures or diagrams with the writing, but sometimes a video is helpful so I know exactly what they are doing.
Videos are also more engaging and I'm less likely to lose focus.
Depends on what the instructions are for though.
@susannah why not both? People learn in different ways.
@susannah YES YES YES. Video is so useless. Takes forever and is just a pic of someone doing the obvious. Don't waste my time with video. Don't just describe that setup/config menu ... I can find the menu and I know how to type stuff into fields, just tell me what each option DOES.
@susannah would you please elaborate? I am curious about this, since I recently started thinking a/v is "better" for non-techies while text is better for machines (something we shouldn't go out of our way to optimize for).
@susannah don't you think there is a chance that preferring (English) text to a/v involves a bias towards able-bodied people (Westerners)? admittedly, text can be accessed via Braille or read out, whereas audio can't be rendered to text as feasibly.
@tetrislife Also, text is typically easier to translate - by people or machines if you're concerned about an English bias
@tetrislife Video documentation is incredibly slow, not searchable, difficult to skim, padded with incredible amounts of bullshit information that you can't skip without possibly missing the one thing you're looking for, useless as a reference, and, if you're making the documentation, is MUCH slower to update or edit. Text is a profoundly accessible technology, especially when it's screen-reader ready with images with good alt-text. Video requires better internet, better computers, and needs transcripts and image descriptions.
Video can be nice when you're learning some hands-on stuff (caulking a bathtub!) but even in those situations, it is far superior to have text + diagram supplemented by a very brief video.
In general, video is a way to waste people's time and get ad money.
@susannah also fuck having to register on your site to access said manual
@Quokka right? Just like 😡 every time that happens.
@susannah so much this
@susannah are we sharing the same employer?