作者 | Radu Coravu
- 1 -
哪些公司受益于使用DITA写文档
一般来说,我会将受益于使用DITA满足其技术文档需求的公司分为三大部分:
1. 制造实体产品的公司
这些公司创造现实世界的实物产品,如汽车、冰箱或计算机芯片。每个产品的每个版本都有一个唯一的产品ID,需要记录下来。不同的产品有时在功能上相似,但也有一些差异。
2. 创建版本化软件产品的公司
这些公司提供版本化的软件组件,通常安装在客户端。由于每个客户可能都有旧版本的产品,因此需要提供旧版本的用户手册。
3. 创建无版本软件产品的公司
这些公司通常提供基于云的服务(SaaS),最终用户始终可以访问最新的稳定版本,并且没有为过去的版本提供用户手册。
- 2 -
具体的益处
使用DITA写文档对公司的益处如下:
益处一:利用DITA的重用(reuse)和条件过滤能力,从同一主手册中生成多个类似但不完全相同的手册
公司类型 | 说明 |
制造实体产品的公司 | 为类似的产品制作手册 |
创建版本化软件产品的公司 | 为类似类型的软件产品制作用户手册 |
创建无版本软件产品的公司 | 为类似类型的软件产品制作用户手册 |
益处二:添加团队所有成员都必须遵循的基于结构的验证规则 - 确保内容一致性
公司类型 | 说明 |
制造实体产品的公司 | 为整个团队使用通用的验证和术语规则 |
创建版本化软件产品的公司 | 为整个团队使用通用的验证和术语规则 |
创建无版本软件产品的公司 | 为整个团队使用通用的验证和术语规则 |
益处三:创建语义元素的自定义词汇表
公司类型 | 说明 |
制造实体产品的公司 | 有助于为公司特定的内容添加特定的语义含义 |
创建版本化软件产品的公司 | 有助于为公司特定的内容添加特定的语义含义 |
创建无版本软件产品的公司 | 有助于为公司特定的内容添加特定的语义含义 |
益处四:除了基于网络的输出外,还可以生成对PDF定制具有较高控制程度的PDF
公司类型 | 说明 |
制造实体产品的公司 | 可用于生成PDF以供打印或在线交付 |
创建版本化软件产品的公司 | 可用于生成PDF以供打印或在线交付 |
创建无版本软件产品的公司 | 可用于生成PDF以供打印或在线交付 |
原文地址:
https://blog.oxygenxml.com/topics/types_of_companies_which_would_benefit_from_the_dita_xml_standard.html