科技文档写作实务

内容简介

《科技文档写作实务》以“理论+实战”的方式,帮助读者在短时间内掌握科技文档写作要领,提高职场竞争力。
全书系统地阐述了技术文档的概念、写作流程、质量要素及典型技术文档的写作方法。
为了帮助读者更好地掌握这些原理,《科技文档写作实务》针对实际工作中经常使用到的需求说明书、概要设计、软件模块详细设计、测试用例、使用指导和故障处理进行专题介绍,从内容框架、写作过程、写作实例、写作要点和常见问题进行了详细说明。

《科技文档写作实务》既可作为产品研发和测试人员、售后支持人员及用户文档开发人员的培训参考用书,也可作为高等院校的教学用书。

作者简介

《科技文档写作实务》以“理论+实战”的方式,帮助读者在短时间内掌握科技文档写作要领,提高职场竞争力。
全书系统地阐述了技术文档的概念、写作流程、质量要素及典型技术文档的写作方法。
为了帮助读者更好地掌握这些原理,《科技文档写作实务》针对实际工作中经常使用到的需求说明书、概要设计、软件模块详细设计、测试用例、使用指导和故障处理进行专题介绍,从内容框架、写作过程、写作实例、写作要点和常见问题进行了详细说明。

《科技文档写作实务》既可作为产品研发和测试人员、售后支持人员及用户文档开发人员的培训参考用书,也可作为高等院校的教学用书。

亚马逊上有

目录

目 录
1 概述篇 1
1.1 什么是技术文档 2
1.1.1 技术文档的定义 2
1.1.2 技术文档的范畴 2
1.1.3 技术文档的特征 4
1.1.4 技术文档的多种形式 4
1.2 技术文档写作的国际国内现状 5
1.3 技术文档写作的重要意义 6
2 基础篇 7
2.1 技术文档写作流程 8
2.1.1 需求分析 9
2.1.2 架构设计 10
2.1.3 文档写作 10
2.1.4 质量控制 11
2.1.5 文档发布 12
2.1.6 文档交付 12
2.1.7 文档维护 12
2.2 需求分析 13
2.2.1 信息收集 13
2.2.2 简化归类 15
2.2.3 分析需求 18
2.2.4 确定文档开发任务 20
2.3 架构设计 21
2.3.1 架构前的准备和学习 21
2.3.2 设计架构 22
2.3.3 架构检查 25
2.4 文档写作 26
2.4.1 写作的逻辑 26
2.4.2 写作6步法 28
2.4.3 写作黄金法则 28
2.5 质量控制 31
2.5.1 质量控制活动 31
2.5.2 高质量文档三要素 34
3 进阶篇 37
3.1 实用性 38
3.1.1 安全第一 39
3.1.2 内容准确 41
3.1.3 面向任务 45
3.1.4 合理组织 49
3.1.5 内容完整 58
3.2 可读性 61
3.2.1 易读 62
3.2.2 易理解 75
3.3 舒适性 85
3.3.1 文档获取便捷 86
3.3.2 内容检索高效 87
3.3.3 阅读感受舒适 92
4 实战篇 101
4.1 如何写需求说明书 102
4.1.1 需求说明书简介 102
4.1.2 需求说明书内容框架 102
4.1.3 需求说明书写作流程 104
4.1.4 需求说明书写作实例 106
4.1.5 需求说明书写作要点 111
4.1.6 需求说明书常见问题 111
4.2 如何写概要设计文档 112
4.2.1 概要设计文档简介 112
4.2.2 概要设计文档内容框架 113
4.2.3 概要设计文档写作流程 114
4.2.4 概要设计文档写作实例 117
4.2.5 概要设计文档写作要点 121
4.2.6 概要设计文档常见问题 121
4.3 如何写软件模块详细设计文档 123
4.3.1 软件模块详细设计文档简介 123
4.3.2 软件模块详细设计文档内容框架 123
4.3.3 软件模块详细设计文档写作流程 124
4.3.4 软件模块详细设计文档写作方法 125
4.3.5 软件模块详细设计文档写作要求 131
4.4 如何编写测试用例 144
4.4.1 测试用例简介 144
4.4.2 测试用例内容框架 144
4.4.3 测试用例写作流程 146
4.4.4 测试用例写作实例 148
4.4.5 测试用例写作要点 152
4.4.6 测试用例常见问题 152
4.5 如何写使用指导文档 155
4.5.1 使用指导文档简介 155
4.5.2 使用指导文档内容框架 155
4.5.3 使用指导文档写作流程 156
4.5.4 使用指导文档写作实例 157
4.5.5 使用指导文档写作要点 171
4.5.6 使用指导文档常见问题 171
4.6 如何写故障处理文档 173
4.6.1 故障处理文档简介 173
4.6.2 故障处理文档内容框架 173
4.6.3 故障处理文档写作流程 174
4.6.4 故障处理文档写作实例 177
4.6.5 故障处理文档写作要点 179
4.6.6 故障处理文档常见问题 179
5 附录 主题类型 183
5.1 概念(Concept) 184
5.2 任务(Task) 185
5.3 参考(Reference) 186