什么样的文档是好的文档：
一个装修需求的描述：
不好的设计文档实例：（平直的陈述）
房子南北走向，房子大门在东侧中间位置。门厅长约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米，把书房和厨房北阳台分隔开。
字如不表、表不如图：
图形表述方式理解更容易，上图已将房间布局信息很清晰表达出来，缺的是尺寸信息，可以在图中标注或附以文字说明，则能完全表达清楚。
图形应具有“自明性”，即只看图，大体上就可理解图意。但不应为追求自明性而使图形过于杂乱，必要时应佐以少量的文字说明。
总之磨刀不误砍柴工。好的工程师，文档写得好是必要条件。
硬件工程师要写哪些文档：
除了原理图，PCB之外，我们还需要哪些文档。
0、项目计划，或者项目任务分配。
WBS：工作分解结构（Work Breakdown Structure） 创建WBS：创建WBS是把项目可交付成果和项目工作分解成较小的，更易于管理的组成部分的过程。
WBS是项目管理重要的专业术语之一。WBS的基本定义 ：以可交付成果为导向对项目要素进行的分组，它归纳和定义了项目的整个工作范围每下降一层代表对项目工作的更详细定义
1、需求跟踪表
在需求阶段明确需求，避免需求遗漏，避免需求理解差错，避免意淫需求。
2、总体设计
关键器件选型、方案框图，关键接口选择。
3、专题分析
时钟、电源、接口等等这些常规专题之外，我们还应该针对项目的薄弱点，制定特殊的专题文档。
比如双Flash启动，FPGA专题，一些你开发的电路板特有的，而且可借鉴的电路很少的，都需要做好理论分析，和试验验证。
4、规则驱动表单
不管是自己Layout，还是别人Layout，关键规则，例如电源走向、线宽、热设计要点、时序要求、信号质量要求等等。。。。
即作为Layout设计指导，也作为设计是否满足要求的checklist。
5、测试计划于测试方案
相当于对电路设计要求的一个梳理。在投板之前，就梳理出要测试的一些要点，以及测试的计划和方法。
6、软硬件接口文档
类似于一些软件需要知道的硬件信息的一个梳理和澄清。I2C器件的地址、CPLD作为总线访问的一些寄存器的地址。
7、详细设计文档
从电路的运行环境，电路的原理、关键器件、接口、可靠性、可维修性、可测试性、对外界依耐性：面板背板接口、电源的需求。分别描述电路的设计思路的要点。
下面的目录文字，摘自《百度文库》：
其他每个环节都类似的文档，便于设计与记录。总之一个思路：把问题尽早暴露，避免问题遗留到项目的后面阶段。越早发现问题，改正问题，这样解决问题的代价越小。
—————广告—————返回搜狐，查看更多