Re:The Tools We Use To Stay Afloat
by dragonwriter on Sunday May 14, 2017 @12:08AM
(#14334169)
> Docs/code impedance mismatch is a problem that a docs tool needs to solve to stay relevant.
It's not an impedance mismatch (which results from difference in the structural representations supported by different systems), it's just a content mismatch. And it's not a tooling problem, it's a process problem. Documentation is the single source of truth for intent, and development process must respect that.
This becomes more and more important the more people who aren't developers need to understand the logical function of the system.
It's not an impedance mismatch (which results from difference in the structural representations supported by different systems), it's just a content mismatch. And it's not a tooling problem, it's a process problem. Documentation is the single source of truth for intent, and development process must respect that.
This becomes more and more important the more people who aren't developers need to understand the logical function of the system.