实用工件是传统的文档驱动方法,通常浪费大量难以置信的工程时间,这些时间仅用于文档的开发,抛光,格式化,审阅,更新,修改和分发。这是一种重定向文档工作的方法,可以简化严格性并轻松理解数据或信息的来源。通过使用智能浏览和导航工具,它还可以对本机信息源进行在线审查。这个想法增加了各种文化问题。
其中一些在下面给出。
- 人们只是想查看数据或信息,但有时却无法理解工件的语言。
一些特定工件的审阅者会反对学习和了解通常用工件编写的工程语言。您会发现许多人,例如资深软件工程师,资深质量保证等,都会拒绝学习语言,只会说“我不想学习和了解统一建模语言(UML),但我宁愿查看软件设计,所以只给我一个简单的描述,例如流程图和文本,我可以很容易地理解它们。” - 想要查看数据或信息的人无权访问所需的工具。
工具的不可用性在开发组织中非常普遍。这些组织还没有完全用工具完成。很难找到有时有能力在线审查工程工件的利益相关者,这几乎是罕见的,有时几乎是不可能的。即使这些组织也被迫彼此交换和共享纸质文档。如今,所有利益相关者都可以使用统一格式语言(UML),电子表格,C++等可视化工具和Web等标准化格式以电子方式交换和共享信息,非常方便,便捷。 - 人类可读的工程工件必须使用完全完整,一致且以自记录方式使用的严格符号。
- 对于所有标识和描述,我们应该使用良好的语法,正确拼写的正确英语单词。
- 应避免使用缩写词和首字母缩写词,并且仅当在使用组件的上下文中可接受时才应使用缩写词和首字母缩写词。
- 该代码应具有自我说明性。
- 主要重点应放在可读性上,即使在所有工程工件中都应使用适当的语法词。
所有这些实践将使表示变得简单易懂,易于浏览的格式,更严格的符号表示法,并最大程度地减少错误发生率。
- 有用的文档是自定义的。
这些是通常非常有用并被使用的文档。 - 纸是有形的。
更改为电子产品非常容易。甚至更改在线和基于Web的工件也非常容易和简单。人们也高度怀疑他们。这是由于它们固有的波动性。