1．源程序文档化
　　源程序文档化主要包括：标识符的命名、程序中添加注释以及程序的编辑风格。

　　（1）标识符的命名
　　标识符即符号名，包括变量名、模块名、常量名、标号名、函数名、数据区名和缓冲区名等。一个程序中必然有很多的标识符，特别是在一个复杂大型的程序中，标识符可能成千上万，对标识符作用的正确理解是读懂程序的前提，如果程序员随意命名标识符，程序的可读性会很差。
　　因此，标识符的命名应该要规范化，具体要根据下面几个原则来命名。
　　① 选取有实际意义的标识符名称。为了方便理解标识符的作用，标识符的名字要能够反映其作用，如用于存储数量的变量的名称可以是count等。
　　② 为了便于程序的输入，标识符的名字不宜太长。必要时可以用一些缩写，但是要注意缩写规则要一致，并且要给每一个变量加上注释。
　　③ 为了便于区分，不同的标识符不要取过于相似的名字。
　　④ 由于程序中通常需要大量不同类型的标识符，为了使说明部分阅读起来更加清晰，在对其进行类型说明时应注意以下几点：按照某种顺序对各种类型的变量进行集中说明，如先说简单类型，再说明记录类型；在使用一个说明语句对同一类型的多个变量进行说明时，按照变量名中的字母顺序进行排列。

　　（2）程序中加注释
　　注释是程序员与日后的程序读者之间通信的重要工具，用自然语言或伪码描述。它说明了程序的功能，特别在维护阶段，对理解程序提供了明确指导。一些正规的程序文本中，注释行的数量占到整个源程序的1/3～1/2，甚至更多。注释分序言性注释和功能性注释。
　　① 序言性注释：一般置于每个程序模块的开头部分，它应当给出程序的整体说明，用来引导读者理解程序。主要描述内容可以包括：程序标题、程序功能说明、主要算法、接口说明、有关数据描述、程序位置、开发简历、程序设计者、复审者、复审日期和修改日期等。
　　② 功能性注释：一般置于程序体中，用来描述其后的语句或程序段是用来做什么的，或者是执行了其下面的语句或程序段会产生什么样的效果，而不要解释下面该怎么做。
　　（3）程序的编辑风格
　　为了使程序的结构一目了然，可以在程序中利用空格、空行、缩进等技巧使程序层次清晰，便于程序的理解。可以按照以下几个原则来编辑程序。
　　① 恰当地利用括号，可以突出运算的优先性，避免发生运算错误。
　　② 程序段之间可用空行隔开。
　　③ 对于选择语句和循环语句，应该做适当的缩进，使得程序的逻辑结构更加清晰。

　　2．数据说明
　　在程序设计时，应该注意数据说明的风格。为了使数据定义更易于理解和维护，有以下指导原则。
　　（1）数据说明顺序应规范化，使数据的属性更易于查找，从而有利于测试、纠错与维护。原则上，数据说明的次序与语法无关，其次序是任意的，但是便于阅读和理解，最好使其规范化，使说明次序按照某种规则固定。例如，按以下顺序：常量说明、类型说明、全程量说明及局部量说明。
　　（2）语句中变量的说明应有序化，多个变量在同一个说明语句中说明时，各变量名按字典序排列。
　　（3）使用注释来说明复杂的数据结构时，要说明在程序实现这个数据结构时的特点。

　　3．语句结构
　　单个语句结构是编码阶段的任务，语句结构追求简单直接，不能为了追求效率而使代码复杂化。我们可以根据下面的原则来构造语句。
　　① 为了便于阅读和理解，不要一行多个语句。

[1]  [2]  [3]  [4]