Documentation is not state secrets / Documentation is subtle self-promotion

Success Is More Than Not-Failing (Write the Docs, 2015)

We talk a lot about minimum viable products, and building our products up from small features. We talk a lot about failure, and how to learn from it and not replicate failures over and over again. But what I haven’t heard a lot of discussion about is how we know we’ve succeeded. Is it market share? Usable product? Could understanding and setting measurable, achievable goals help us overcome imposter syndrome, second sock syndrome, and feature creep?

This talk provides some metrics on identifying success, documenting what it will look like when you get there, preserving the idea, and dealing with the inevitable distractions and changes in direction that may prevent you from ending up where you expect.

I’ll speak on how documentation can serve a crucial function at both defining and driving success. We need to stop believing that agile is the end of the answer and embrace it as part of building what we want to have in the end.

Continuous improvement can have a victory condition, if we build it.