[bentona]

Maybe an aside, and I don't necessarily disagree that async is sometimes inefficient, but it's more efficient if you bias for reading instead of writing. For example, take 15-20 minutes to write the thing, so it only takes 3-5 minutes to parse.

This matters because async can become more efficient than sync when it prevents you from having to repeat yourself, but you lose this efficiency if you don't invest in clear writing that is easy to parse (repeatedly) to begin with.

[kerpotgh]

Definitely, async has its place and it’s for long term documentation. Most daily things in engineering do not fall into that bucket in my experience.