Writing is key to have impact in large organizations. As a senior software engineer chances are that writing is the most important skill you have to acquire in order to increase your scope beyond the team and advance your career.
Writing is hard. Many Software engineers struggle with writing. Personally I never had an intrinsic interest in literature, so writing did not naturally come to me either. I have spent days and weeks agonizing and procrastinating around larger writing tasks. And to this day, having pressure to produce high-quality documents on a deadline gives me nightmares.
This article contains some learnings that have helped me (and others) to become better and more productive as a writer over the past 15 years. I am sharing them in the hope, that you find them useful. However, don’t think that I am always able to follow this advice myself 😅. I still have a lot to learn.