Member-only story
Active documentation
Documenting, a task that is perceived as “expensive” but that in the long term is profitable.
One of the main reasons why documenting is a task that is perceived as “expensive” in time and effort lies in our concept of generating it. This is linked to bad experiences we may have suffered when creating or consuming it.
When we think about documentation, we associate in our mind the need to receive or create a document. This document will be a “deliverable” in docx, pdf or similar format.
If said document is written with care, that is, without an obvious hurry to finish it after having left it for the final phase of the project, we will ensure that said document is kept updated in time. To this end, a table is usually included at the beginning of it, to record the changes that occur in it.
Once the project has been delivered and completed (at least in principle) in our mind, only hope will be disguised as an expectation that this document will be updated every time a change or update is made to our product. But this rarely happens and we know it.
We have several problems with this way of working:
- The documentation is in a final format that can be copied, altered and edited in one of its copies. This causes us insecurity…
