如何理解软件文档表达与软件文档涉众间的关系

来源:百度知道 编辑:UC知道 时间:2024/06/21 04:20:15

软件文档表达与软件涉众间存在着并不十分明确的依赖关系。软件文档表达要根据不同类型的涉众来选择文档视图表达方式和文档写作方式,这样才能使得文档更清晰,易于阅读,向涉众提供高效的帮助信息。以下是对两者关系的理解:
①软件文档是提供给其涉众使用的,在进入编档前,就应该根据文档涉众的需要,就编档什么和编档的详细程度作出决策,必要时,还必须决定自己是否应该定义一种新的文档风格或格式规范,以便更好地支持新项目的需要,或覆盖两个或更多的文档种类或视图风格。
②应该了解,在编档过程中,在什么情况下需要哪些视图以及文档需要什么样的详细程度等。这些问题只能在项目的具体情况中,根据项目的实际以及涉众的具体要求确定。换句话,编档者只有在了解以下情况时,才能确定文档中需要哪些视图,应该何时创建它们,以及编制文档时需要采用什么样的详细程度,从而使项目开发取得成功:
•可参与编档的都有哪些人?他们的编档专业技能如何?
•编档的预算有多少?
•有没有根据项目进度的编档进度表?
•文档的重要涉及是否明确?
③系统文档需要有合适的涉众来阅读和使用,而文档涉众也希望能够获取适合的文档。因此,涉众对文档的选择完全取决于他希望使用什么样的文档。对于大多数的系统而言,都应该为其将来的各类文档涉众提供他们预期使用的文档。
④作为编档者,应该清楚自己需要为哪些涉众提供什么样的文档,了解他们需要什么类型的信息,以及这些信息的详细程度。然后利用这些信息来决定需要什么样的文档表达方式,包括视图的类型等,以及如何将这些内容加以妥善的组织,使之能够方便为涉众提供支持的文档包。

顶你!!给分!!

又是桂电的……

我知道~~刚从 软件文档这本书抄完那5题作业题.现在写详细设计说明书~~~