bahmanmAug 19, 2023

[DISCUSS] Pros/cons of videos for technical documentation?

https://lemmy.ml/post/3560552

[DISCUSS] Pros/cons of videos for technical documentation? - Lemmy

cross-posted from: https://lemmy.ml/post/3560540 [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? > > [https://lemmy.ml/pictrs/image/33853fb4-f520-4975-80cd-b873de5bf22d.png]

Show threadpopcar2
It really depends on what’s being taught imo. If it’s something purely text-based like programming then sure, I absolutely would prefer reading an article to watching a video. For most tutorials though I think there’s benefit in seeing things done visually step by step. Most tools are visual, so learning stuff like 3D modelling or video editing through text can be difficult, but seeing someone do it in front of me makes everything click since I know exactly what he did and don’t have to read between the steps.
Aug 19, 2023 at 3:19pmWeb
Show threadmangotopAug 19, 2023
even for visual programs, I absolutely despise the 10min videos for something that I only really care about 5 seconds of. If visual programs had the option of decent text tutorials (with screenshots) it’d be much easier to get into