技术设计文件的工具和标准

Ale*_*roR 7 architecture

我想知道我的同事现在使用哪些工具和标准用于技术设计文档.

过去在我公司工作时,我们只提供客户端 - 服务器win-apps,我们为设计文档提供了文字模板.我们的模板总是从数据库图开始,然后是UI模型,字段映射,功能描述等...使用Word和Visio,我们已经足够了.但最近我们正在整合维基,UML图表,原型设计工具等......没有真正强大的标准和工具政策.您是否认为让建筑师自由选择他们认为适合每个项目的特定时刻的工具和标准,或者公司是否应该对此进行执行和标准化?

Mil*_*s D 1

任何设计文档背后的原因都是与所有相关人员进行清晰的沟通。因此,从这个角度来看,无论您作为架构师选择什么工具,最终的产品都需要立即由所有相关人员以及稍后的维护人员阅读。因此,至少选择一些相当标准的工具是有意义的,这些工具在几年内仍然存在。

也就是说,设计文档通常用于启动和运行项目或系统。此后,有良好文档记录的代码和一些基本文档就足够了。我可能会更加关注文档的组织,以便人们将来可以轻松找到他们想要的内容。它可以帮助强制执行某种标准存储库结构/系统来存储文档,但不一定坚持使用各种文档模板。关注内容而不是工具。