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

Wouldn't more devs using your tool be lovely?

I'm a consulting developer experience engineer and educator who helps developer tools accelerate adoption. I can lower your initial learning curve so developers can get to Hello World faster and start building cool stuff with your APIs and SDKs.
Get Daily Tips