【问题标题】:Development Documentation [closed]开发文档[关闭]
【发布时间】:2011-01-02 08:18:32
【问题描述】:

我们是一个开发团队,我们需要记录我们的代码。 每个开发人员都在处理可以称为模块的代码的一部分。 我们需要一个具有此规范的文档

  1. 应该易于实现和使用
  2. 每个开发人员都记录了她/他自己的工作,当另一个开发人员需要了解任何模块时,他/她不应该有义务向原始开发人员询问文档。他/她应该能够自己找到该文件。
  3. 我们应该能够搜索整个文档。

您对此有什么建议吗?

【问题讨论】:

  • 这真的取决于语言生态系统。指定语言和/或平台可能会产生更好的响应。此外,还应考虑“辅助”文档生成、处理和存储策略。

标签: documentation code-documentation


【解决方案1】:

大多数语言都有从代码 cmets 生成文档的方法。 Java 和 JavaScript 都有将 cmets 转换为 API 规范的方法,例如 Java 的 Javadocs。这实际上取决于您使用的平台。

【讨论】:

  • 确实如此。 VS/.NET、Scala、Perl、Python、Ruby 等也是如此。语言和生态系统在“公认”(且易于使用)的工具方面确实发挥了作用。
【解决方案2】:

您谈论设计决策、要求等?

为什么不使用 wiki(我们使用 PmWiki)进行此类协作?

【讨论】:

    猜你喜欢
    • 2010-12-05
    • 2012-08-27
    • 1970-01-01
    • 1970-01-01
    • 2018-01-20
    • 1970-01-01
    • 1970-01-01
    • 2015-10-05
    • 2023-04-01
    相关资源
    最近更新 更多