Re:Ask HN: How to encourage and maintain a long term organiz...
by codingdave on Thursday February 07, 2019 @07:41AM
(#19104835)
It sounds like you already know the answer - you need a single persistent tool for documentation that is open to all for reading and editing. It doesn't matter what that tool is, just that it exists, and that you build an environment where keeping it up to date, and using it, are a core part of your culture.
As far as how to get that culture, it starts with constant reminders. If someone asks a question in slack, answer it via documentation, and send the link in slack. If people send you long answers or explanations, ask them to put it into the tool. When people come on board, give them access to the tool and see how far they get before they get stuck... then add answers to whatever questions stopped them.
It doesn't happen overnight, but it doesn't take years either. A few months of solid focus on just doing it, and you'll be in a better place.
As far as how to get that culture, it starts with constant reminders. If someone asks a question in slack, answer it via documentation, and send the link in slack. If people send you long answers or explanations, ask them to put it into the tool. When people come on board, give them access to the tool and see how far they get before they get stuck... then add answers to whatever questions stopped them.
It doesn't happen overnight, but it doesn't take years either. A few months of solid focus on just doing it, and you'll be in a better place.