代码之家  ›  专栏  ›  技术社区  ›  bhadra

软件设计和体系结构文档[已关闭]

  •  2
  • bhadra  · 技术社区  · 17 年前

    记录软件设计和体系结构的最佳实践和软件工具是什么

    1. 基于Java的PC应用

    2. 基于VxWorks或嵌入式Linux或Windows CE的嵌入式应用程序?

    我想到的一个工具是 Enterprise Architect . 这是一个好的选择吗?

    1 回复  |  直到 12 年前
        1
  •  2
  •   Peter Howe    17 年前

    这在很大程度上取决于文件的目的。读者群是谁?它是用来推动开发活动,还是用来提供历史记录?制作/使用此文档的团队有多大?

    在我们的小型开发团队中,我们发现笔/纸和wiki对于大多数架构/设计文档来说都是足够的。一些设计/架构决策也可以纳入到代码注释中(但如果要使用文档来推动开发,这显然毫无意义)。我们经常使用的两个专业工具是数据库图表/部署工具(例如 DBWrench )和UML图表工具(如 ArgoUML ).

    警告一句:不要制作需要花费大量精力才能维护或不会被任何人阅读的文档。