C'est sur que trop de commentaires.. tuent le commentaire.
D'un autre coté tu as les solutions suivantes :
- Que des commentaires dans la langue maternelle du dev de base / des gens constituant le noyau dur de base. Tout le monde comprend tout parfaitement, mais tu met une barrière à l'entrée au niveau des codeurs qui parlent pas la même langue.
- Que des commentaires en anglais. Tu te retrouves bien souvent avec une soupe de mot anglais mis bout à bout .Ce qui donnent non pas des phrases compréhensive, mais juste une concaténation de mot anglais. Concaténation incomprises par la plupart des gens de langue anglaise. Voir pire encore (j'en ai lu) des explications en anglais de cuisine, mais compréhensible mais qui expliquaient l'inverse de ce qu'elles auraient du expliquer.
Utiliser uniquement la langue que la plupart des gens sont capable de baragouiner pour commenter ton code (sachant que commenter le code c'est super important tout de même, ca doit être clair, précis, concis, pédagogique, et surtout utile au lecteur) c'est à mon avis un nivellement par le bas dangereux.
Après tu peux aussi refuser les dev qui ne savent pas parler anglais correctement. Pourquoi pas.
Du coup, je propose une solution qui ménage la chèvre et le choux, en doublant les
commentaires.
Tu me diras d'un autre coté, proposer de doubler les commentaires dans la langue maternelle du créateur du projet, ou de celle du noyau dur, c'est bancale aussi. Parce qu'après tout même si effectivement le créateur du projet ne va pas changer souvent de langue maternelle, le noyau dur du projet peut dans le temps changer, et donc la "deuxième langue" des commentaires évoluer.. (Imagine que dans 4 ou 5 ans le noyau dur de Logram soit composé de 12 polonais .. c'est effectivement un problème).
Au final, j'ai pas de solutions miracles. Ca serait carrement plus simple si les gens écoutaient coluche et que tout le monde parlait français :). Mais ce n'est pas le cas.
Dans tout les cas, je pense que se rabattre sur une solution "bancale" de baragouiner de l'anglais parce que "l'anglais tout le monde le comprend a peu près et l'écrit presque", c'est vraiment loin d'être une panacée, au vu de l'importance que devraient avoir les commentaires.
J'en viendrais presque à proposer des équipes de traducteurs pour les commentaires, comme il y en a pour la doc, avec des commentaires localisés, pour chaque pays. C'est peut-être pas si con en fait comme idée d'ailleurs ...
[^] # Re: Dommage
Posté par Mr JMad . En réponse à la dépêche Logram, environnement de bureau totalement différent, fête ses 1 ans.. Évalué à 1.
D'un autre coté tu as les solutions suivantes :
- Que des commentaires dans la langue maternelle du dev de base / des gens constituant le noyau dur de base. Tout le monde comprend tout parfaitement, mais tu met une barrière à l'entrée au niveau des codeurs qui parlent pas la même langue.
- Que des commentaires en anglais. Tu te retrouves bien souvent avec une soupe de mot anglais mis bout à bout .Ce qui donnent non pas des phrases compréhensive, mais juste une concaténation de mot anglais. Concaténation incomprises par la plupart des gens de langue anglaise. Voir pire encore (j'en ai lu) des explications en anglais de cuisine, mais compréhensible mais qui expliquaient l'inverse de ce qu'elles auraient du expliquer.
Utiliser uniquement la langue que la plupart des gens sont capable de baragouiner pour commenter ton code (sachant que commenter le code c'est super important tout de même, ca doit être clair, précis, concis, pédagogique, et surtout utile au lecteur) c'est à mon avis un nivellement par le bas dangereux.
Après tu peux aussi refuser les dev qui ne savent pas parler anglais correctement. Pourquoi pas.
Du coup, je propose une solution qui ménage la chèvre et le choux, en doublant les
commentaires.
Tu me diras d'un autre coté, proposer de doubler les commentaires dans la langue maternelle du créateur du projet, ou de celle du noyau dur, c'est bancale aussi. Parce qu'après tout même si effectivement le créateur du projet ne va pas changer souvent de langue maternelle, le noyau dur du projet peut dans le temps changer, et donc la "deuxième langue" des commentaires évoluer.. (Imagine que dans 4 ou 5 ans le noyau dur de Logram soit composé de 12 polonais .. c'est effectivement un problème).
Au final, j'ai pas de solutions miracles. Ca serait carrement plus simple si les gens écoutaient coluche et que tout le monde parlait français :). Mais ce n'est pas le cas.
Dans tout les cas, je pense que se rabattre sur une solution "bancale" de baragouiner de l'anglais parce que "l'anglais tout le monde le comprend a peu près et l'écrit presque", c'est vraiment loin d'être une panacée, au vu de l'importance que devraient avoir les commentaires.
J'en viendrais presque à proposer des équipes de traducteurs pour les commentaires, comme il y en a pour la doc, avec des commentaires localisés, pour chaque pays. C'est peut-être pas si con en fait comme idée d'ailleurs ...