“Most of the rules that apply to writing long-form documents like Tech Narratives, Blog Posts or Papers hold up for writing short documents like E-Mails or issue tickets. Use this documents to practice your writing skills, by make them well structured, usable and polished.-Heinrich Hartmann, “Writing for Engineers.” HeinrichHartmann.com. April 15, 2022.
If I were to break down what I think of as important in writing.
- Write more frequently, less long. These are the building blocks for longer pieces. Make a daily habit of it if you can. My monthly Zuihitsu and my favorites from this blog are good examples.
- Use the Minto Pyramid Principle. It provides a good structure. Try this summary one sheet.
- Simplify your text using tools like The Hemingway Editor, which I have thoughts on. Eighth grade or below is a good level for a general audience.
- Know your audience.
- Using different tools, like the Webster’s Revised Unabridged Dictionary (1913) to give your writing a different flavor.
I’ll add more to this as it occurs to me.