Tout à fait, je veux faire le contraire. A la limite, je demande même pas à avoir des organigrammes. Je peux me débrouiller sans. C'est surtout qu'il faut pas mal documenter les sources des shell script.
Il y a encore de nos jours, des gros "cake" qui ne documente pas leur fonction, ce qu'elles font en bon français en listant les arguments en entrée avec leur type et ce que ca represente et le code retour s'il y en a un.
J'aime bien prendre exemple sur le code source de Dotclear. La manière dont sont documentés les fonctions PHP dans les sources de ses classes est vraiment formidable.
[^] # Re: FreeDFD ?
Posté par Fluke . En réponse au journal PHPXref pour les scripts Shell. Évalué à 1.
Il y a encore de nos jours, des gros "cake" qui ne documente pas leur fonction, ce qu'elles font en bon français en listant les arguments en entrée avec leur type et ce que ca represente et le code retour s'il y en a un.
J'aime bien prendre exemple sur le code source de Dotclear. La manière dont sont documentés les fonctions PHP dans les sources de ses classes est vraiment formidable.