Keeping documentation in line with the implementation is notoriously difficult.
保持文档与实现的一致是众所周知的难题。
One of the biggest issues for most projects is keeping documentation in sync with the code that actually implements it.
大多数项目的一个最大的问题是使文档与实际实现它的代码保持同步。
InfoQ: What advice can you give to help teams sustain the change, keeping the "living" aspect of the documentation alive?
InfoQ:你能给团队什么建议来帮助他们维持这种改变,并保持活文档的“活性”呢?
Wikis have proven to be an effective media for keeping architectural documentation.
Wiki被证明为维护架构文档的一种有效的媒介。
To get the long term benefits teams have to invest in keeping the living documentation system consistent.
为了获得长期的受益,团队必须保持活文档系统的一致性。
The fundamental reasons why a project produces architectural documentation are communication, analysis and record keeping (e.g. keeping track of decisions over time so they don't get lost).
一个项目产生架构文档的根本原因是为了交流、分析、记录和保存(比如,跟踪决策过程使之不会随着时间而流失)。
The fundamental reasons why a project produces architectural documentation are communication, analysis and record keeping (e.g. keeping track of decisions over time so they don't get lost).
一个项目产生架构文档的根本原因是为了交流、分析、记录和保存(比如,跟踪决策过程使之不会随着时间而流失)。
应用推荐