cross-posted from: https://lemmy.ml/post/3560540

You probably have already noticed that nowadays it’s becoming fashionable online to share technical material via videos (eg YouTube.)

I somehow can understand the appeal of creating videos for sharing thoughts/news, esp b/c it takes way less time and focus compared to writing things (just hit the record button and go.)

But videos are. 👎 not index-able (at least locally)
👎 not searchable. 👎 not copy-paste friendly if at all. 👎 impossible to skim through.
👎 a major distraction from the train of thoughts.

IMO, in most cases, the more effective and impactful medium of technical comms is the written form: a Mastodon toot, a blog post, a gist, a Pastebin entry or even a Facebook post!

What are your thoughts?

  • glad_cat@lemmy.sdf.org
    link
    fedilink
    arrow-up
    2
    ·
    1 year ago

    I hate videos. I’d rather read a book with 500 pages than watch a video about anything. Actually, I don’t think I’ve ever watched a technical video in my whole life.

  • cmeerw@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    1 year ago

    If it’s a YouTube video, it probably has been made to monetise, not to share tech material. So I usually avoid YouTube, because most of the time it’s not worth it.

  • atheken@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    1 year ago

    Demo videos are not “documentation.” They are “demos.”

    If you want someone to repeat your steps, it should be code or CLI commands. You can write more descriptive text, but as soon as you reference pictures to show something, you’re introducing ambiguity that text/code can avoid.

    UIs change faster than videos and screenshots, as you said, can’t be searched, and are generally less accessible than text.

    The source files for documentation should also live side-by-side with the code in the repo. As soon as it goes anywhere else, it immediately goes out of date.

  • haruki@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    edit-2
    1 year ago

    Well, obvious reason: you can’t edit an outdated video with easy effort. But with text you can.

    But for a tech talk or demo, I’d still prefer a video than written text.

  • Durotar@lemmy.ml
    link
    fedilink
    arrow-up
    1
    ·
    1 year ago

    Can’t ctrl+f a video. People don’t often have good presenting skills, talk slowly or with defects. Text is much easier to navigate, faster to read.

  • neil@programming.dev
    link
    fedilink
    arrow-up
    0
    arrow-down
    1
    ·
    1 year ago

    Technical videos have helped me perfect my pronunciation of “umm” and “uhh.”