This article is written front-loaded with vague ideologies, basic mostly-intuitive foundational concepts followed by a random mishmash of general tips. I was hoping for a more applied and structured tour with effective examples that work for common classes of problems.

A reasonable starting place: The best design document conveys the critical aspects, requirements, and relevant information in a way the audience will understand and be able to further reason about.

p.s. Sorry for the complaint, I was a bit disappointed because this is potentially a really interesting subject! Why does cargo-cult content get such good traction so consistently? Cargo-cult driven design leads to some odd outcomes IME. Sigh