农夫百科

技术文稿本词条为多义词,与多类属交叉,分属或被包含于:农夫百科农夫文稿农夫物库

添加义项

本词条是多义词收起

———本词条由农夫云物库编制中心规范发布

技术文稿

技术文稿(技术文档)

英文称为Technical Documentation

从业者称为Technical writer

研发文档

指研发过程中使用的文档。英文一般称为Specification。

文档中详细记录产品的研发目的,开发阶段,研发时限等。阅读对象一般为了解项目,有一定基础的工程师。文档作为项目执行的参考,为项目的如期完成,项目质量跟踪,以及项目的后续发展等问题提供了可依据的文字上的依据。

研发文档.jpg

客户文档

指产品发布以后,公布给用户使用的文档。英文一般称为Customer Documentation。

文档详细解释产品的具体使用方法,安全提示,客户服务信息等。阅读对象一般为用户,技术支持工程师,售后服务人员。文档作为产品和市场接轨的桥梁,为产品的在市场上赢得客户的青睐,以及产品的长期发展做出了良好的保障。

技术文档的要求

技术文档要符合以下要求:

1.针对性

文档编制以前应分清读者对象,按不同的类型、不同层次的读者,决定怎样适应他们的需要。

① 对于面向管理人员和用户的文档,不应像开发文档(面向软件开发人员)那样过多地使用软件的专业术语。 难以避免使用的词汇,应在文档中添加词汇表,进行解释。

② 开发文档使用的专业词汇未被广泛认知的,应添加注释进行说明。

③ 缩写词未被广泛认知的,应在其后跟上完整的拼写。

2.正确性

① 没有错字,漏字。

② 文档间引用关系正确。

③ 文档细节(Title/History)正确。

3.准确性

① 意思表达准确清晰,没有二义性。

② 正确使用标点符号,避免产生歧义。

计算机操作准确性.jpg

4.完整性

① 意思表达完整,能找到主语、谓语、宾语,没有省略主语,特别是谓语。

② 一句话中不能出现几个动词一个宾语的现象。

③ 不遗漏要求和必需的信息。

5.简洁性

① 尽量不要采用较长的句子来描述,无法避免时,应注意使用正确的标点符号。

② 简洁明了,不累赘冗余,每个意思只在文档中表达一次。

③ 每个陈述语句,只表达一个意思。

④ 力求简明,如有可能,配以适当的图表,以增强其清晰性。

6.统一性

① 统一采用专业术语和项目规定的术语集。

② 同一个意思和名称,前后描述的用语要一致。

③ 文档前后使用的字体要统一。

④ 同一课题若干文档内容应该协调一致,没有矛盾。

7.易读性

① 文字描述要通俗易懂。

② 前后文关联词使用恰当。

③ 文档变更内容用其他颜色与上个版本区别开来。

④ 测试步骤要采用列表的方式,用1)、2)、3)…等数字序号标注。

参考文献

文章来源:百度百科及农夫百科

原始创建:佚名

词条概况

版本编辑:2次

最近更新:2018-01-29

历史浏览:2136次

最新编辑:佚名

原始创建:佚名

词条标签:字词,语言,社会,生活

阅读是一种智慧,分享无比快乐!

感谢阅读与分享本词条,每一词条都是您赢得财富和建造知识大厦的一块砖,一块块砖的堆砌必将成就卓凡不俗的您。欢迎收藏并拥有本文,请注册农夫大学网成为VIP会员,免费分享与下载,另有更多惊喜等着您。

做农夫大学网版主,参与相关活动,尊享农夫国积分计划福利,分享更多快乐与幸福,还有众多幸运实惠不恰从天而降被砸中机会,快来参加哦!

各类实用文档、海量文稿、上万册电子书,在线阅读与下载

成为农夫大学网VIP会员免费阅读与下载

云物库 - 技术文稿

所需农夫币:1.00元RMB/NFB

阅读是一种智慧,分享无比快乐!

各类实用文档、海量文稿、上万册电子书,在线阅读与下载

关于我们广告服务联系我们

Copyright © 2015-2018 农夫国 All Rights Reserved.