Sara Rosso shares some thoughts on what to document and share, after publishing over a 1,000,000 words while working at Automattic. Ā Here’s the gist of it:
- If youāre the go-to person forĀ something in your company, consider how much of itĀ is just gatekeeper information you could document properly to help someone else learn/grow from or work on independently.
- Separate out processes and historical backgroundĀ from your strategic expertise.Ā Processes and backstory are not really āwhat you know.ā Itās much better to be a person someone asks āwhyā or āwhenā to do something vs. the logistics of a āhow.ā How can and should be documented for others to build off of regardless of your involvement. This should free you up to be more involved in the why, the new, and the next of your work.
- If youāre repeating yourself in private chats or (gasp!) email on a specific topic, document it. Thatās also what drove me to create this blog ā being able to answer someoneās question with an answer youāve already carefully crafted for someone elseĀ is a great feeling (and a great use of your time)!
- Will someone want to know why you decided or executed something a specific way later? Share as much background as possible so colleagues are brought up to speed immediately. Share the setupĀ & thought process you went through, where to find more information, and even the facts, ideas, or information you considered but deemed outside of scope for the particular project. My goal is to hopefully never have someone ask āwhere did this come from?ā or āwhatās your source?ā or ādid you consider this?ā (when I had) and instead focus on enriching the discussion or challenging my ideas vs. asking me for information I should have provided in the original post.
- Gather the best, most complete, or authoritative things youāve authored and submit them as potential onboarding materials for new team members. Challenge them to ask questions and to find something you need to document.
- If important progress is made, be sure to update your documentation, or retire in favor of something newer or more complete. We do this by linking from old posts to new ones, and all it takes is a quick comment and a link on an old post.