Recommended read: Writing In Public, Inside Your Company - The Kool Aid Factory https://koolaidfactory.com/writing-in-public-inside-your-company/
A lukewarm take about why you should use natural language, so someone not-as-technical can read it and still derive value.
Recommended read: Allowlist, not whitelist. Blocklist, not blacklist. Goodbye, wtf. Microsoft scans Chromium code, lops off offensive words https://www.theregister.co.uk/2019/09/03/chromium_microsoft_offensive/
This is a super interesting thread from Justin Garrison about the importance of words, using Disney as an example. It's always amazing to see examples of how these seemingly small changes can make huge differences.
Recommended read: "here's a thread about how words matter in business using Disney as an example" - Justin Garrison https://twitter.com/rothgar/status/1139968357438857217
This is another post you really need to read, if you haven't already, as it makes you really think about the way you communicate.
I know a lot of people who use the term 'you guys' as a gender-neutral term, but after reading this article it really helps persuade you that the term is actually not as inclusive as you think.
For a couple of years now I've been making an effort to use gender-neutral ways to address groups, and I hope after reading this you will too.
Recommended read: You Guys https://www.xaprb.com/blog/you-guys/
Being able to write semi-readable written text with technical terminology is a huge skill, and makes such a difference compared to not being able to write it.
I've found that since blogging more, my written language has gotten a lot better, and significantly makes my job easier.
I've worked with a number of brilliant engineers who can't explain themselves as well in written forms, which means commit messages and core pieces of documentation are difficult to understand.
Remember that you're never going to be the only person reading something, so make your content well thought out, re-read it and ask someone else to read through it to check it's OK.
Recommended read: https://blog.pragmaticengineer.com/on-writing-well/ https://blog.pragmaticengineer.com/on-writing-well/
Context is key: thinking about your audience (5 mins read).
How to have inclusive conversations by providing the right context for those who may not have the same level of understanding.