软件工程读后感10-代码阅读方法与实践4-526互联

最近，我阅读了代码阅读方法与实践的下一部分。
意义重大的编码工作，或大型、有组织体制之下的项目，比如GNU和BSD，都会采纳一套编码规范、指导原则或约定。计算机语言和编程系统为程序员如何表达一个给定的算法提供了大量的余地。代码规范提供风格上的指导，目标是增强代码的可靠性、易读性和可维护性。过去，我对于代码规范的重视程度不够，将来，我会尝试重视编码过程中的代码规范。
大多数规范都会说明文件应该如何命名，应该使用什么样的扩展名。过去，我对于文件命名和文件扩展名的了解不够深入，将来，我会尽可能的了解一些命名的规范。
现代块结构语言编写的程序，都使用缩进来强调每个块的嵌套层次。风格指南经常规定用来缩进代码块的空格的数量和类型。过去，我对于缩进的重视程度不够，将来我会尝试更加重视缩进。
软件系统并非只是代码。因此，许多编码指导原则都延伸到开发过程的其他领域，包括文档、生成和发布过程的组织。至少，许多指导原则都会规定标准的文档，以及编写它们的格式。由于最终用户文档经常与应用程序或发布过程紧密地绑定在一起，故而常常组织的最好。过去，我对于非编码领域的重视程度不够，将来我会尝试更加非编码领域。
应用传统工程方法的项目，在开发过程中，会生成大量不同的文档。当这些文档得到正确维护时，它们确实能够帮助您理解系统的基本原理、设计和实现。过去我对于文档的重视程度不够，将来我会尝试写一些文档。
在阅读文档时，要时刻注意，文档常常会提供不恰当的信息，误导我们对源代码的理解。过去，我错误的认为文档中的东西都是正确的，将来我会更加深入的了解文档。