Etsy's Take on Documentation
This week, my team and me are busy polishing our documentation. These are the markdown files in the docs/ folder of our git repo and the confluence pages for communicating across teams. These are the functional specs that people reference daily and the SRE Playbook entries we pray we don’t need to look at. We have documentation in all shapes and sizes. When there is so much stuff to manage, making sure that documentation doesn’t become stale or irrelevant can easily become cumbersome.