There is a never-ending tension
between the perceived need for exhaustive documentation - and the
cost/effort to produce/maintain it.
The
level of need exists on a spectrum - and will vary depending on a
number of requirement forces: Mortality Risks, Regulatory Compliance, Complexity of
System Design and Integration, Accessibility to Source Code, Degree of
Reliance/Integration with external/isolated Third-Party Systems, Degree
of Dependencies between Manual vs. Automated Processes, etc.
There
is no silver bullet - but I am constantly seeking out new ideas,
techniques, strategies, and lessons-learned for optimizing this
particularly challenging problem.
Cyrille Martraire
has published a new book this year, "Living Documentation: Continuous Knowledge Sharing by Design" - which I plan to add to my reading stack
in the near future. Looking forward to reading his insights and
suggestions.
No comments:
Post a Comment