文档（documentation）就是关于一个程序的信息，描述了程序并说明它是如何工作的。注释是程序文档的一部分，不过在代码本身以外，文档还包括其他部分，文档描述一下内容：
为什么写这个程序（它的用途）这个程序是谁写的这个程序面向什么人（它的用户）如何组织1、当行注释
在任何代码行前面加上‘#’符号就可以把它变成一个注释。（这个符号叫做数字符号，有时也叫做镑符号）
下面举例说明，代码清单：
运行结果：
可以看出，程序运行第一行会被忽略。注释只是用来方便你和其他人读懂代码。
2、行末注释可以在一行代码的最后加注释，比如：
area = length * width #计算矩形的面积注释从#字符开始，#之前的所有内容都是正常的代码，在它后面的所有内容则是注释。
3、多行注释有时可能想使用多行注释，在每行前面都有一个#字符，比如：
# **********# 这个程序用来说明Python中如何使用注释# 星号所在的行只是为了将注释# 与其它的代码清楚的分开# **********多行注释可以很好的突出代码段，在读代码时能清楚的区分不同代码段。程序最开始的多行注释可以列出作者的名字、gxdxf、编写或更新日期，以及其它有用的信息。
三重引号字符串Python中还有一种方法可以相当于多行注释。只需建立一个没有名字的三重引号字符串。比如:
""" 这是一个包括多行的注释，使用了三重引号字符串。这并不是真正的注释，但是相当于注释"""因为这个字符串没有名字，而且程序对这个字符串不做任何处理，所以它对程序的运行没有任何影响。它相当于一个注释，尽管从严格意义上来讲并不是一个真正的注释。
注释程序还可以使用注释临时跳过程序中的某些部分，作为注释的所有内容都会被忽略。
# print ('hello')print ('world')由于print ('hello')被注释掉，所以这一行不会执行，不会打印‘hello’。
调试程序时，如果只希望某些部分运行而将另外的部分忽略，这样做会很有用。如果希望计算机忽略某些代码行，只需要在那些代码行前面加一个#，或者在这段代码前后加上三重引号。
大多数代码编辑器（包括IDLE和SPE）都有一个特性，允许你很快地注释整个代码块（也可以很快地取消注释）。在IDLE的编辑器中的Format菜单，在SPE编辑器中的Edit菜单。