Déjà, ne pas utiliser d'abréviations: l'auto-complétion, s'pas pour les chiens.
Et finalement, utiliser des noms qui veulent dire quelque chose, (削除) de préférence (削除ここまで) qui se réfère au rôle de la variable/fonction/méthode/classe.
Cette phrase à le mérite de bannir les noms à 1 lettre, sauf cas particuliers: i, j pour les compteurs de boucle, x, y, z pour des coordonnées…
Il m'arrive d'utiliser le mot "ret" (abréviation) parce que return est un mot-clé, cependant. Tmp aussi, même si c'est rare et limité à de très petites fonctions/méthodes, et idem j'essaie d'éviter.
J'ai vu des conseils qui indiquent d'utiliser des noms pour les variables et objets et des verbes d'action pour les méthodes/fonctions, c'est pas trop mal, mais parfois limité quand on utilise l'anglais (print? Mais print what?) donc je dirais garder le coup du verbe d'action et le compléter si nécessaire (printPageNumber, ah, ok).
Ensuite, je pense que le reste c'est en fonction du langage et des conventions de l'équipe:
* si t'as pas de typage fort, la notation hollandaise n'est pas une mauvaise idée, sinon si.
* si le langage tends à utiliser camelCase, et que l'équipe veut faire du code qui soit aisément distinguable de la lib standard, on peut vouloir utiliser les _ pour séparer les mots, par exemple.
* si l'équipe préfère utiliser le français pour coder, l'utiliser.
* …
A noter: rien de tout ça ne doit être utilisé comme règle absolue :)
[^] # Re: Sélection naturelle
Posté par freem . En réponse au journal To comment or not to comment. That is the question.. Évalué à 3. Dernière modification le 24 avril 2013 à 11:00.
Déjà, ne pas utiliser d'abréviations: l'auto-complétion, s'pas pour les chiens.
Et finalement, utiliser des noms qui veulent dire quelque chose,
(削除) de préférence (削除ここまで)qui se réfère au rôle de la variable/fonction/méthode/classe.Cette phrase à le mérite de bannir les noms à 1 lettre, sauf cas particuliers: i, j pour les compteurs de boucle, x, y, z pour des coordonnées…
Il m'arrive d'utiliser le mot "ret" (abréviation) parce que return est un mot-clé, cependant. Tmp aussi, même si c'est rare et limité à de très petites fonctions/méthodes, et idem j'essaie d'éviter.
J'ai vu des conseils qui indiquent d'utiliser des noms pour les variables et objets et des verbes d'action pour les méthodes/fonctions, c'est pas trop mal, mais parfois limité quand on utilise l'anglais (print? Mais print what?) donc je dirais garder le coup du verbe d'action et le compléter si nécessaire (printPageNumber, ah, ok).
Ensuite, je pense que le reste c'est en fonction du langage et des conventions de l'équipe:
* si t'as pas de typage fort, la notation hollandaise n'est pas une mauvaise idée, sinon si.
* si le langage tends à utiliser camelCase, et que l'équipe veut faire du code qui soit aisément distinguable de la lib standard, on peut vouloir utiliser les _ pour séparer les mots, par exemple.
* si l'équipe préfère utiliser le français pour coder, l'utiliser.
* …
A noter: rien de tout ça ne doit être utilisé comme règle absolue :)