top | item 31496328

(no title)

unop | 3 years ago

Documentation-as-an-artefact of the continuous delivery process - every feature is feature-complete only when counterpart documentation is generated and integrated/built as part of the pull-request procese.

I.E. A code/solution review must also consider the documentation alongside the feature or solution.

This implies that the documentation is (held beside) source code too and can be diffed/compared e.g. Markdown for text, mermaid/graphviz for diagrams and that this can be built, rendered or published easily/readily (Hugo, zola, etc)

discuss

order

No comments yet.