En même temps, ton patron ne te paye pas pour commenter ton code, même s'il te le reprochera.
Généralement quand il s'aperçoit que tu commentes il te donne autre chose d'urgent, mais il te rappellera que tu ne commentes pas ton code le jour ou il en aura besoin.
Sans compter, les projets qui commencent sans réelle cahier des charges mais qui doivent être fini pour hier.
Et au moment ou tu leur montres ce qu'ils t'ont demandé, là tout est à refaire (y compris ta doc) car par le truchement de ton commercial qui est en contact avec LE cadre de la boite de vendeur de (Chausssures|Parfumerie|Pistolets|...) le projet ne répond plus à ce que pensais le cahier des charges qui était dans la tête de ce cadre mais qu'il ne t'as pas dit car sinon c'est pas assez sportif comme métier informaticien. Mais bon si ce cadre savait informatiquement parlant ce qu'il voulait tu n'aurait plus de métier.
Dans l'exemple type, une fois, j'ai commencé par un simple ftp avec gestion des droits sur fichiers en http pour finir par un workflow complet entièrement recomposable.
Sur ce genre de projet tu comprends que documenter complètement en codant peut te faire perdre du temps.
D'ailleurs je vous signale, au passage, que le w3 essaye de mettre une norme pour les workflows des services webs après oasis et le workflow group.
Bien sur je ne parle même pas des deadlines assassinent qui dynamiteront les élans lyriques.
[^] # Suivant le projet tu documentes ou pas,
Posté par Samaty Tramo . En réponse au journal à quand un code commenté ?. Évalué à 3.
Généralement quand il s'aperçoit que tu commentes il te donne autre chose d'urgent, mais il te rappellera que tu ne commentes pas ton code le jour ou il en aura besoin.
Sans compter, les projets qui commencent sans réelle cahier des charges mais qui doivent être fini pour hier.
Et au moment ou tu leur montres ce qu'ils t'ont demandé, là tout est à refaire (y compris ta doc) car par le truchement de ton commercial qui est en contact avec LE cadre de la boite de vendeur de (Chausssures|Parfumerie|Pistolets|...) le projet ne répond plus à ce que pensais le cahier des charges qui était dans la tête de ce cadre mais qu'il ne t'as pas dit car sinon c'est pas assez sportif comme métier informaticien. Mais bon si ce cadre savait informatiquement parlant ce qu'il voulait tu n'aurait plus de métier.
Dans l'exemple type, une fois, j'ai commencé par un simple ftp avec gestion des droits sur fichiers en http pour finir par un workflow complet entièrement recomposable.
Sur ce genre de projet tu comprends que documenter complètement en codant peut te faire perdre du temps.
D'ailleurs je vous signale, au passage, que le w3 essaye de mettre une norme pour les workflows des services webs après oasis et le workflow group.
Bien sur je ne parle même pas des deadlines assassinent qui dynamiteront les élans lyriques.