Love and hate: the story of documentation


Most of the teams I was a part of was in a never-ending quest for the documentation sweet spot. The place that you don’t have spend too much time maintaining it and the docs bring value and are up to date.

For some the starting point was from agile manifesto or software craftsmanship misunderstanding, which is not-documenting at all. Others decided to build a comprehensive docs to discover soon it is a challenge to keep it up with the reality (well, um, the code).

I will share some of the solutions the team and I enjoyed, and some that we definitely hated.