Coding tutorial video pet peeves

calling tutorial videos to avoid these kinds of things
2025-03-22 12:04 // updated 2026-02-18 18:22

When it comes to tutorial videos (any kind; it could even have a non-coding topic), the following frustrate me:

  • 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 as much of it 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 insights) ➡️
Code as total algebra 🔡
⬅️ older (posts)
🧑🏻‍💻 "Object arithmetic" with JavaScript
newer (posts) ➡️
Code as total algebra 🔡