我们为什么要写文档?

我们为什么要写文档?

模板

需求

SRS文档

接口文档

设计

概要设计

详细设计

软件设计

移植设计

什么样的文档是好的文档:

一个装修需求的描述:

不好的设计文档实例:(平直的陈述)

房子南北走向,房子大门在东侧中间位置。门厅长约3米,宽2米,门厅左面是主卧室,右面是厨房。厨房3米宽,4米长,厨房门对着门厅,厨房的顶头还有一个北阳台,与厨房同宽,长1米。主卧室宽3米,长5米左右,房间门对着客厅。客厅与餐厅连为一体,共7米长,4米宽,与客厅相连有一南阳台,与客厅同宽,长1.5米。

餐厅的北面是卫生间,卫生间与厨房相对,中间由1米宽,3米长的过道隔开;卫生间门对着过道,南墙与厨房的南墙在一条直线上;卫生间为长方形,南墙长3米,另一边长2米。卫生间的北面是次卧,同宽,门朝着过道,次卧长4米。过道的北端是书房门,书房南北长4米,书房有一个一米见方的门厅,书房的西墙长4米,包括1米长的门厅长度,西墙把书房和次卧分隔开。门厅东墙北端90角折向东,长2米,把书房和厨房北阳台分隔开。

优化后的设计实例:(只是简单地进行了分段,阅读起来更有层次感更清晰。同时修正了“约”、“左右”等模糊的描述。)

1.房子南北走向,房子大门在东侧中间位置。

2.门厅长3米,宽2米,门厅左面是主卧室,右面是厨房。

3.厨房3米宽,4米长,厨房门对着门厅,厨房的顶头还有一个北阳台,与厨房同宽,长1米。

4.主卧室宽3米,长5米左右,房间门对着客厅。

5.客厅与餐厅连为一体,共7米长,4米宽,与客厅相连有一南阳台,与客厅同宽,长1.5米。

6.餐厅的北面是卫生间,卫生间与厨房相对,中间由1米宽,3米长的过道隔开;卫生间门对着过道,南墙与厨房的南墙在一条直线上;卫生间为长方形,南墙长3米,另一边长2米。

7.卫生间的北面是次卧,同宽,门朝着过道,次卧长4米。

8.过道的北端是书房门,书房南北长4米,书房有一个一米见方的门厅,书房的西墙长4米,包括1米长的门厅长度,西墙把书房和次卧分隔开。门厅东墙北端90角折向东,长2米,把书房和厨房北阳台分隔开。

总之磨刀不误砍柴工。好的工程师,文档写得好是必要条件。

硬件工程师要写哪些文档:

1、需求跟踪表

在需求阶段明确需求,避免需求遗漏,避免需求理解差错,避免意淫需求。

2、总体设计

关键器件选型、方案框图,关键接口选择。

3、专题分析

时钟、电源、接口等等这些常规专题之外,我们还应该针对项目的薄弱点,制定特殊的专题文档。

比如双Flash启动,FPGA专题,一些你开发的电路板特有的,而且可借鉴的电路很少的,都需要做好理论分析,和试验验证。

4、规则驱动表单

不管是自己Layout,还是别人Layout,关键规则,例如电源走向、线宽、热设计要点、时序要求、信号质量要求等等。。。。

即作为Layout设计指导,也作为设计是否满足要求的checklist。

下面的目录文字,摘自《百度文库》:

其他每个环节都类似的文档,便于设计与记录。总之一个思路:把问题尽早暴露,避免问题遗留到项目的后面阶段。越早发现问题,改正问题,这样解决问题的代价越小。

返回搜狐,查看更多

相关手记

枿的解释
买情侣装去哪个网站,情侣装买哪个网站好 → 情侣装网站推荐
方管和圆管哪个承重力更强?