未来的工作和开发者文档

Question

在您看来，文档是否应该列出在应用程序开发中需要进一步完成的内容，而不是描述设计决策和算法的开发人员文档？能够解释为什么更清楚地做或不这样做的意见的原因会很棒。提前感谢您的评论。

Answer 1

是的，现有系统的文档和未来未来变更的文档应该是分开的。

最重要的文档是当前系统及其功能。从维护的角度来看，预期的变化并不能提供任何有价值的东西 - 只是杂乱无章。根据各种因素（最有可能是资金支持），可能会确定前瞻性变化的重要性较低，并相应地调整时间表。