How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
2017-07-27 23:32
731 查看
Content comes from: http://blog.slickedit.com/2007/05/how-to-write-an-effective-design-document/
第一部分:阐述你的工程需要解决什么问题,目标的用户是谁。同时,通过写这个部分,你可以知道你的目标工程是否合理且有存在的意义。
第二部分:从high level去阐述这个工程的构成部分有哪些,简要介绍他们的功能。这里需要用到entity diagram去阐述。例如:
第三部分:详细地介绍每个模块的内容。如果这个模块是某个接口的实现类,就可以在这里详细叙述。
通常需要叙述的内容:1/ 用一段介绍其usage,不需要be verbose. 2/ 是否有什么special configuration,这里可以讲述下一些特殊的函数参数的作用。 3/ 用类UML去介绍下这个模块的类族。
例如:
第四部分:Interaction Diagram. 当前模块之间的通信图。例如:
第五部分:阐述下总体的benefit 和 risk.
第一部分:阐述你的工程需要解决什么问题,目标的用户是谁。同时,通过写这个部分,你可以知道你的目标工程是否合理且有存在的意义。
第二部分:从high level去阐述这个工程的构成部分有哪些,简要介绍他们的功能。这里需要用到entity diagram去阐述。例如:
第三部分:详细地介绍每个模块的内容。如果这个模块是某个接口的实现类,就可以在这里详细叙述。
通常需要叙述的内容:1/ 用一段介绍其usage,不需要be verbose. 2/ 是否有什么special configuration,这里可以讲述下一些特殊的函数参数的作用。 3/ 用类UML去介绍下这个模块的类族。
例如:
第四部分:Interaction Diagram. 当前模块之间的通信图。例如:
第五部分:阐述下总体的benefit 和 risk.
相关文章推荐
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- how to write extension for firefox -- 如何给firefox编写插件
- How to write vc resource to a file in vc6.0(在VC6.0中如何把资源文件写成文件)- Software Bind CockHorse Tech(软件绑马技术)- C++ SourceCode
- How to Write an Effective Design Document
- How to set Item Level Permission for SharePoint 2007 (MOSS/WSS) List/Document Library Programmatically
- How To Create Custom Skins For DotText(如何为DotText创建自定义风格的皮肤)
- A VS MPF bug, about how to write good virtual fucntion
- 如何成为一位杰出的工程师-How to be a Star Engineer (转)
- 如何给上传控件上色【HOW TO SET CSS FOR THE CONTROL OF FILEUPLOAD】
- How to Design a Good API and Why it Matters(转)
- 5 Tips for creating good code every day; or how to become a good software developer
- How to Configure Eclipse for Python --- 在eclipse中如何配置pydev
- How to write Assembly code for the iPhone:
- Android 如何在自定义界面上启用输入法 (How to enable inputmethod for the custom UI)
- Rapid Contextual Design: A How-to Guide to Key Techniques for User-Centered Design