When not writing in Bash, Perl, Python, and Ruby we write in English: Writing Tips
By Brian Dillon · June 15, 2012
It is as important for our team to improve our skills writing for humans as it is writing code for computers, says our CTO Jon Jensen. He's right. Thankfully he had a good list of tips for us to make our human writing as effective as our code.
Here are a few great gems:
- Don't be afraid of bullet-points ;-)
- Keep it short
- Understand your audience
Jon's recommendations led to some End Pointers to share writing tips of their own:
- Use the final thought of your first draft in the beginning of the final message
- Writing out a lot, and cutting down 90% of it
- When it comes to emails: Lay out clear actionable steps you want a person to take in the beginning or in the last sentence of an email, not buried in a thick paragraph.
- For important, longer documents, do editing the day after
- Always re-read anything before you send it
- Reading what you've written out loud is great way to catch mistakes
- Have the wisdom to know when not to reply or send something
- Don't be afraid of using the phone if your thoughts aren't concise enough for an email