话题的分类
话题(topic)分为三类:
- 任务话题(task topic):介绍某一任务的简要目的和背景;列出完成某一任务的所有详细步骤。
- 概念话题(concept topic):介绍什么是什么和背景信息。
- 参考话题(reference topic):提供任务话题的补充材料,如术语表、各种定义等。
为什么要做话题分类
- 方便内容的重复利用。假如某个产品有用户手册(user manual)和在线帮助(online help),这两种文档里都提到了相同的内容,在这种情况下,如果有可以重复使用的段落就可以只维护一个源文档,其他文档引用这个源文档即可。这样做既省去了重复劳动,又能让文档的更新同步到所有其他文档中去。
- 方便信息的模块化。话题分类有利于让信息的呈现更明确。如果把各类信息糅合在一个话题里,读者需要自己在头脑中加工所获取的信息,影响效率。话题分类使得每个话题只聚焦一个主题,让信息更“纯净”,排除其他类信息的干扰,从而让读者理解起来更容易。