Comment on On Writing WellComments−rramadass2yFor Technical Writing, follow "The Minto Pyramid Principle" (https://untools.co/minto-pyramid/), keep everything Concise, Precise, use Assertive/Definitive voice and show Usage with Examples in the beginning itself.−zodvik2yAt Stripe, this was also framed as BLUF - bottom line up front.−rramadass2yBLUF is a Military standard; see article linked to under the "sources" section of the above link.
Comments
For Technical Writing, follow "The Minto Pyramid Principle" (https://untools.co/minto-pyramid/), keep everything Concise, Precise, use Assertive/Definitive voice and show Usage with Examples in the beginning itself.
At Stripe, this was also framed as BLUF - bottom line up front.
BLUF is a Military standard; see article linked to under the "sources" section of the above link.