Book:Writing on the Job (2022)
Book quotes
From Writing on the Job: Best Practices for Communicating in the Digital Age by Martha B. Coven (2022)
Your purpose in writing at work is to communicate to other people [...] it's not about you; it's about them.
Even if your audience does have substantial background knowledge, it can still be useful to provide some brief context before you plunge into your core content. While you have been thinking about this topic, your readers have likely been focusing on other matters and could use help getting their heads into the issue. That said, your purpose should not be to convey everything you note, but rather to identify and share the information your audience needs. (note: my emphasis)
If your audience is seeking information to solve a problem or answer a question, make sure to address their needs directly. Good writing anticipates and answers the reader's questions.
Always construct your headings in a parallel manor. You can use full sentences, fragments that start with a verb, or fragments that start with a noun. Just don't mix and match.
Related articles
Questions/notes from my reading that I've explored (and will continue exploring).