Et puis, pour les sources, le code lui-même est très facile à comprendre pour un anglophone, car justement, quand un francophone voit «Process->startDetached(processName, Qt::ProcessFork)» par exemple, il a du mal à comprendre.
Dans un bon code source (à mon avis), le code doit pouvoir se lire presque comme on lirait des phrases, grâce à un nommage approprié, des groupements d'instructions judicieux et un découpage fonctionnel assez granuleux et atomique pour ne pas perdre le fil de la lecture.
Les seuls commentaires qui doivent rester doivent être à mon avis de deux types :
- La documentation des API (du genre doxygen, jsdoc ou whatever)
- La documentation des parties du code un peu délicates à comprendre, un calcul algorithmique pointu par exemple.
Et ces deux types de commentaires, il est exclu à mon sens de les mettre en français pour que le code soit pérenne au niveau collaboration internationale car ce sont précisément des commentaires que tu ne retrouveras pas en lisant juste le code.
[^] # Re: Dommage
Posté par Guillaume Denry (site web personnel) . En réponse à la dépêche Logram, environnement de bureau totalement différent, fête ses 1 ans.. Évalué à 6.
Dans un bon code source (à mon avis), le code doit pouvoir se lire presque comme on lirait des phrases, grâce à un nommage approprié, des groupements d'instructions judicieux et un découpage fonctionnel assez granuleux et atomique pour ne pas perdre le fil de la lecture.
Les seuls commentaires qui doivent rester doivent être à mon avis de deux types :
- La documentation des API (du genre doxygen, jsdoc ou whatever)
- La documentation des parties du code un peu délicates à comprendre, un calcul algorithmique pointu par exemple.
Et ces deux types de commentaires, il est exclu à mon sens de les mettre en français pour que le code soit pérenne au niveau collaboration internationale car ce sont précisément des commentaires que tu ne retrouveras pas en lisant juste le code.
My 2 cents.