Coding tutorial video pet peeves

calling tutorial videos to avoid these kinds of things
2025-03-22 12:04
// updated 2026-01-01 20:39

Tutorial videos: for those who have tried to learn software programming from YouTube (and other websites, even paid "code academy" types of sites), we have all experienced these kinds of frustrations:

  • excessive display of the vlogger's face
    • it's okay to have their face in the beginning to "know the instructor"
    • by and large, the viewer just wants to see the code
    • they need to consider "screen real estate"
      • code is small and we need to see it as much as possible
  • music and/or noise in the background
    • it's okay to have them in the beginning of the video for "ambiance"
    • music should not happen when coding as it feels distracting to some
  • naming variables and things that are specific to the vlogger's use case
    • code should be as versatile, with timely variable names
      • e.g. not priceOfCoffee but priceOfProduct
    • the watcher will want to apply the code to as many different situations as possible
  • fumbling around with the specifics of styling
    • they should focus on order and flexibility, rather than pixel perfection
  • going too quickly for complex and important issues
    • they should not jump from one screen to another in a matter of seconds
    • they should not jump from one part of the code, to another, and another, in less than ten seconds
    • SLOW DOWN when talking about something important
  • going too slowly for simple issues
    • they should not take minutes to explain "2 + 2"
    • SPEED UP for things that everyone should know
    • avoid rambling just to make the video longer
  • using the word "here"
    • if they want people to "code along", they should not say the word "here" because learners are likely only listening and not watching while they "code along"

Sure, unlike a classroom, we can now also "rewind", "fast forward" and even "slow down" tutorial videos. However, a good tutorial video will try to explain a concept as though the teaching takes place in a real-time, live classroom.

newer (in thoughts) ➡️
Code as total algebra 🔡
⬅️ older (posts)
🧑🏻‍💻 "Object arithmetic" with JavaScript
newer (posts) ➡️
Code as total algebra 🔡