Always give examples. Always. For example… (028)


In this vlog, I will give examples of examples you should use to make an example out of some code.

This episode is all about the importance of including examples in technical blogs and tutorials.

In this episode, I really want you to always think about what the reader can get without them. Take something you don’t know how to do, then take the script from a YouTube show and try to accomplish it. So much harder than when you see what happens. So here I will share practical tips on giving examples of setting stuff up, writing code, and creating scenarios to help readers understand and replicate processes effectively.


Some key points

  • Always include detailed examples in technical content to prove you have at least tried what you are teaching
  • Show your setup and process step-by-step to build trust.
  • When you demo AI include prompts and results. Your readers output will almost certainly be different and it is frustrating when you can’t figure out what you are trying to compare against.

Fediverse reactions

Leave a Reply

Discover more from Drsql's Database Musings

Subscribe now to keep reading and get access to the full archive.

Continue reading