One lesson I learned early in my video course career was to avoid embedding small details in my audio recording that could change in future updates. Obviously, some things can't be avoided like major APIs but small things can be – call it "micro debt."

Some examples of  micro debt:

  • URLs
  • Version numbers
  • APIs on slides
  • Website info


"You can find exercise files at the URL shown here."


"Visit the Postman website and click the download link for your platform."

Is much easier to maintain by editing and replacing a slide image rather than to re-record an audio section that encodes the micro debt.

It's micro debt because if you don't avoid it, you'll have to pay down the road when a course needs updating.

Have a lovely day,

Avoid reading micro debts aloud

Want devs to love your product?

Hi 👋 I'm Kamran. I'm a consulting developer educator who can help your DevRel team increase adoption with better docs, samples, and courseware.
Sign up