3 ms·

For Technical Writing, follow "The Minto Pyramid Principle" (https://untools.co/minto-pyramid/ https://untools.co/minto-pyramid/), keep everything Concise, Prec

For Technical Writing, follow "The Minto Pyramid Principle" (https://untools.co/minto-pyramid/ https://untools.co/minto-pyramid/), keep everything Concise, Precise, use Assertive/Definitive voice and show Usage with Examples in the beginning itself.

zodvik 2y ago
At Stripe, this was also framed as BLUF - bottom line up front.
- rramadass 2y ago
  BLUF is a Military standard; see article linked to under the "sources" section of the above link.