Oui, c'est très bien, et je pense que certains projets s'imposent de documenter leur code de cette manière.
L'étape ultime étant le "litterate programming", un concept de D. Knuth je crois, qui consiste simplement à réaliser un document de conception détaillée, dans lequel le code est inclus. Le code est donc inclus dans la documentation. L'inconvénient (ou l'avantage), c'est que l'on doit modifier la doc en même temps que le code afin que les deux soient parfaitement à jour. De plus, le code étant expliqué en langage naturel, il est plus facile à déchiffrer.
Message édité par el muchacho le 25-04-2004 à 19:00:00