软件工程

本类阅读TOP10

·PHP4 + MYSQL + APACHE 在 WIN 系统下的安装、配置
·Linux 入门常用命令(1)
·Linux 入门常用命令(2)
·使用 DCPROMO/FORCEREMOVAL 命令强制将 Active Directory 域控制器降级
·DirectShow学习(八): CBaseRender类及相应Pin类的源代码分析
·基于ICE方式SIP信令穿透Symmetric NAT技术研究
·Windows 2003网络负载均衡的实现
·一网打尽Win十四种系统故障解决方法
·数百种 Windows 软件的免费替代品列表
·收藏---行百里半九十

分类导航
VC语言Delphi
VB语言ASP
PerlJava
Script数据库
其他语言游戏开发
文件格式网站制作
软件工程.NET开发
有关文档的实用性要求——来自《文档审核意见-关于xx文档》的摘录

作者:未知 来源:月光软件站 加入时间:2005-2-28 月光软件站

有关文档的实用要求

1.       文档不仅仅是给客户的,也是我们此次工程实施的经验总结;

2.       文档必须要实用,为了客户,也为了我们自己!

怎么样的文档才算实用?

1.       目的明确

a)        文档肯定是针对某类问题的说明,因此要求目的明确,针对性强。比如若仅是针对某个模块其中一个版本的说明,则决不含糊其辞,而是在很明显的地方与以说明,决不浪费使用者/读者的时间。

2.       条理清晰

a)        尽可能地以读者角度/思路来合理编排章节;

b)        讲清楚:是什么?为什么?怎么做?等几个问题,必要时还需要增加“谁?”“何时?何地?何种情况?”等一些问题。

3.       一致性

a)        在文中多次出现的有关内容,应该前后描述一致,不自相矛盾;

4.       内容充实

a)        就某个问题的描述,应该言之有物而不夸夸其谈;

b)        若实在没东西讲,应该写明“内容有待细化/补充”;

5.       可操作性

a)        如果文档的特点是针对操作开展,则应该在内容的真实性、可验证性上做足文章。读者能够根据文档的提示一步步完成某项工作;

b)        文档应该尽可能地提供可视化的图片或其他媒体方式,以便内容直观,更易于理解;

6.       体贴

a)        在文中出现对有关内容的引述,应该尽可能提供链接,以免读者四处搜索遍寻不着;




相关文章

相关软件