3 ms·
Documentation has a tendency to not keep up with what it is documenting, etsy has a great blog post about this and their shift in philosophy around documentati
by quadrature 7y ago
Documentation has a tendency to not keep up with what it is documenting, etsy has a great blog post about this and their shift in philosophy around documentation https://codeascraft.com/2018/10/10/etsys-experiment-with-immutable-documentation/ https://codeascraft.com/2018/10/10/etsys-experiment-with-imm... .
we've adopted something similar at work where we've necessitated that all support related questions be asked through https://www.discourse.org/ https://www.discourse.org/ . This allows the most timely solutions to surface to the top and if a question hasn't been asked before it gets thrown into a slack channel where a subject matter expert can answer it. Making this one change has monumentally reduced the support burden of our teams.