Salut à tous, Je vous sollicite pour un petit partage d'expérience concernant la documentation du code (commentaires ou documents annexes). Avez-vous des bonnes pratiques à recommander?
Pour être plus précis, j'aimerais instaurer des pratiques un peu plus rigoureuses sur le sujet au sein de notre équipe de développement, afin d'obtenir un code bien documenté et, chose importante, de manière homogène (que les commentaires aient tous le même formalisme). Avez-vous des conseils à ce sujet? Les questions que je me pose sont : - que documentez-vous? (tous les fichiers? toutes les méthodes?) - comment documentez-vous? (avez-vous un modèle de commentaire? quelles informations gardez vous : auteur, date de dernière modif, description? utilisez-vous rdoc?...) Je sais que Ruby a l'avantage d'être très intuitif, donc de nécessiter moins de commentaires explicatifs, mais je pense qu'il ne nous en dispense pas complétement... Merci d'avance pour vos réponses! -- Posted via http://www.ruby-forum.com/. -- Vous avez reçu ce message, car vous êtes abonné au groupe "Railsfrance" de Google Groups. Pour transmettre des messages à ce groupe, envoyez un e-mail à l'adresse [email protected] Pour résilier votre abonnement envoyez un e-mail à l'adresse [email protected]
