Lorsqu'on veut rentrer dans un programme et faire une modification, ou tout simplement colaborer, si le programme est d'une bonne taille, ca devient difficile de comprendre les tenants et aboutissants du code.

J'aimerai mettre au point un méthode pour expliquer le code, je pense pour de l'Open Source. Et dire aussi comment et ou coder.

La question est donc pour expliquer votre code vous commenceriez par quoi (textuellement, car UML c'est jolie mais ca suffit pas).

Perso pour ma méthode OMOS (open method open source):
- je commencerai par expliquer l'architecture générale je crois (a plugin, event driven etc...)
- la délimitation et la responsabilité des couches
- la description détaillé de morceaux de code hardus
- des modes opératoires (façon de faire) sur comment si prendre pour rajouter des fonctions dans le respect de l'architecture (pour conserver de la cohérence).

Et vous ? Est ce que vous avez l'expérience de l'Open source ?