3 ms·
I wrote about this a while back, relating my experiences of spending months documenting an SRE operations team [1]. Since then I've learned that there's an opt
by zwischenzug 7y ago
I wrote about this a while back, relating my experiences of spending months documenting an SRE operations team [1].
Since then I've learned that there's an optimum time to document, and it's not early in the project. That led me to look at the Cynefin framework [2], which prods you to classify where you are on the maturity scale of an activity, which in turn gives you a clearer idea of what to do next.
The corollary (and I've experienced this a few times since) is that it's a waste of time to document early in the maturity cycle, as much changes; too fast for your docs to keep pace. It's like imposing an enterprise HR function on a small startup - incongruous and likely to lead to friction.
Picking the right time to start taking documentation seriously is an interesting problem.
[1] https://zwischenzugs.com/2017/04/04/things-i-learned-managing-site-reliability-for-some-of-the-worlds-busiest-gambling-sites/ https://zwischenzugs.com/2017/04/04/things-i-learned-managin...
[2] https://en.wikipedia.org/wiki/Cynefin_framework https://en.wikipedia.org/wiki/Cynefin_framework