Il est conseillé de placer en première ligne d’une classe nouvellement créée une chaîne de caractères, décrivant le rôle de ladite classe.
En effet, il existe un système de documentation automatique des classes en Python, qui affichera la première ligne de la classe Point (si c’est une chaîne de caractères) quand vous taperez (par exemple) :
>>> class Point : ... "Définition d'un point mathematique" ... >>> help(Point)
ou, si p est une instance de la classe Point,
>>> print p.__doc__