• 软件测试技术
  • 软件测试博客
  • 软件测试视频
  • 开源软件测试技术
  • 软件测试论坛
  • 软件测试沙龙
  • 软件测试资料下载
  • 软件测试杂志
  • 软件测试人才招聘
    暂时没有公告

字号: | 推荐给好友 上一篇 | 下一篇

想编写出优秀技术文档,先学学这四招

发布: 2009-6-10 11:25 | 作者: 不详 | 来源: 测试时代采编 | 查看: 38次 | 进入软件测试论坛讨论

领测软件测试网 拥有准确的技术文档不仅对于公司是非常有益处的,而且也能够让客户从中受益。由于产品如何使用在某种程度上是要依赖技术文档来进行说明的,因此技术文档必须十分的准确可靠。使用不准确的和已经过时的技术文档对于公司的发展也会产生一定的阻碍,同样的,它也会对公司的客户们产生消极的影响。一旦客户发现在他们使用产品的时候遇到了问题,却不能通过求助于伴随产品的技术文档的手段进行解决的时候,客户们就会对这种产品产生怀疑乃至于失去信心,那么,公司的信誉和利益自然而然的就会受到损害。这就是不准确的和过时的技术文档给我们带来的危害。

  缺乏准确性以及内容晦涩难懂都会让开发新手以及其他的一些技术工作者们对这些技术文档敬而远之,从而不利于他们的学习和掌握。在本篇文章中,我们要讨论的就是如何在你的开发小组中编写出准确而且易于掌握的技术文档。

  技巧一:制定出一个技术评价核对表

  许多的程序开发设计者以及管理者都缺乏从技术上评价一个文档的经验。这里有一些方法可以提高这些技术文档的准确性:

  把注意力集中于技术事实上,这样能够核实这些技术是作为技术文档而被编写出来的。技术评论的工作并不等同于一般的编辑工作。

  一定要从技术上核实,在技术文档里编写的程序与步骤的准确性。

  一定要从技术上核实,在技术文档中使用的图片捕捉的准确性。

  技巧二:一定要在技术文档编写的过程中明确责任

  技术文档编写不好的一个原因常常是由于对它不够重视。这是由于在编写技术文档的时候,没有十分的明确各种责任。因此,一定要在技术文档编写的过程中明确责任,这些方法包括:

  在技术文档中加入作者以及相关人员的姓名。一些公司可能有规定,禁止出现员工的姓名,但是在技术文档中包含作者以及相关人士姓名的做法能够促进这些内部员工之间的交流。对于外部的文档使用者,比如为商业现货软件编写的用户指南,可以加入作者以及相关人员的姓名,用以明确和承认他们对开发所做的工作和贡献。

  把文档的技术评论作为提供给开发设计人员的年度评论的一部分。

  在项目计划中指派专人负责技术评论的工作。

  技巧三:增加技术文档编写者的准确性

  由于技术文档编写者在许多公司内都是非常主观的一个职位,并且编写技术文档也是他们最主要的职责,因此做这些工作的人都必须与他们所编写的技术文档的准确性有着直接的利害关系。

  管理人员应该为技术文档编写者设置适当的技术准确级别,并要求他们把准确性保持在这一范围之内。由于一些技术文档编写者对于提升自己对于技术的理解总是不太积极主动,因此,增加他们的责任让他们面对更多的压力对项目里的每一个人来说都是有好处的。如果一个技术文档编写者无法达到更高的标准,那么你就需要重新审视一下你的技术文档编写者是否能够满足你们的团队的战略要求,是否能够满足客户们的需要呢?

  为了帮助技术文档编写者,你需要让他们对于具体的技术有着更深层次的认识,因此,作为管理者,你应该:

  让技术文档编写者多参加有关产品设计与开发的小组会议。

  

延伸阅读

文章来源于领测软件测试网 https://www.ltesting.net/

TAG: 编写 技术 文档

21/212>

关于领测软件测试网 | 领测软件测试网合作伙伴 | 广告服务 | 投稿指南 | 联系我们 | 网站地图 | 友情链接
版权所有(C) 2003-2010 TestAge(领测软件测试网)|领测国际科技(北京)有限公司|软件测试工程师培训网 All Rights Reserved
北京市海淀区中关村南大街9号北京理工科技大厦1402室 京ICP备10010545号-5
技术支持和业务联系:info@testage.com.cn 电话:010-51297073

软件测试 | 领测国际ISTQBISTQB官网TMMiTMMi认证国际软件测试工程师认证领测软件测试网