4 ms·
Quantifying human processes is not one of my strengths, however these are some situations a culture of writing helps avoid: - Fear to go on vacation or take si
by schmichael 7y ago
Quantifying human processes is not one of my strengths, however these are some situations a culture of writing helps avoid:
- Fear to go on vacation or take sick days because you'll miss live decision making
- Paternity/Maternity or other extended leave requiring a second onboarding upon return
- Animosity when left out of a lunch or beer where a design was discussed or decision was made
- Cabals of knowledge holders weaponizing their knowledge for job security or advancement
- Onboarding is a huge drain on existing workers as all knowledge must be shared 1:1 synchronously. Discourages team growth.
- Bias toward risk takers and the loudest voices. Difficult for thorough and thoughtful team members to be effective.
If none of these things apply to you, great! I don't want to presume there's one best way of operating.
- rtx 7y agoDo you write about or teach these things.
- schmichael 7y agoIronically: no. It's something we discuss regularly at HashiCorp and, as you might expect, have a lot of internal resources (docs, videos, training) around. I haven't looked at it myself, but I know Google just released some training materials for technical writing: https://developers.google.com/tech-writing https://developers.google.com/tech-writing