Mes conventions de codage...
Par NiKo le mercredi 23 juillet 2008, 21:21 - Dev - Lien permanent
... sont celles des projets sur lesquels je me greffe. C'est en effet pour moi une forme de respect que d'appliquer les standards de codage partagés par une communauté (ou une équipe) de développeurs : ainsi, on maximise les chances de se comprendre et on minimise les coûteuses phases de communication entre geeks introvertis[1] 
En effet, rien de plus pénible que de reprendre le code de quelqu'un qui a pris des libertés avec des conventions établies à ce niveau, l'apothéose étant obtenue avec ce genre de code :
<?php class Ma_superClasse { function dire_coucou ( $popol) { echo 'coucou ' . $popol . ' !' ; } function DireAuRevoir($Popol ) { print "Au revoir $Popol !"; } }
Je force bien évidemment ici le trait, mais tout le monde est déjà tombé sur ce genre de code illisible, qui multiplie par 10 votre temps d'intervention sur ce dernier et divise par 1000 votre passion pour la TMA.
Bien entendu, il peut arriver de produire du code sur un projet ne nécessitant l'utilisation d'aucune brique logicielle existante. Auquel cas vous pouvez librement appliquer vos propres standards de codage, l'important étant ici qu'ils soient cohérents et constamment appliqués. S'il peuvent être ceux d'un projet open source existant reconnu, cela augmentera la sympathie potentielle à votre égard de futurs intervenants sur votre code 
Je noterai quand même en vrac quelques bonnes pratiques générales globalement reconnues et appréciées :
- être explicite,
- indenter son code,
- documenter son code,
- à choisir entre les deux, privilégier la lisibilité à la concision,
- utiliser des noms de variables, de classes, de méthodes, de fonctions et d'arguments parlants,
- utiliser des noms anglophones,
- utiliser des motifs de conception connus.
Personnellement, j'ai mes petites préférences et tout comme Oncle Tom - qui m'a gentiment refilé cette chaîne[2] - j'ai tendance à appliquer les standards de codage de symfony, que je trouve homogènes et cohérents. Mais ce sont là bien évidemment essentiellement des questions de goûts et de couleurs.



















Commentaires
1. Le mercredi 23 juillet 2008, 21:55 par thoas
2. Le mercredi 23 juillet 2008, 22:09 par thibault
3. Le mercredi 23 juillet 2008, 22:20 par Quentin
4. Le mercredi 23 juillet 2008, 22:24 par NiKo
5. Le mercredi 23 juillet 2008, 22:31 par Geoffrey
6. Le mercredi 23 juillet 2008, 23:09 par Clochix
7. Le jeudi 24 juillet 2008, 01:04 par Fabien
8. Le jeudi 24 juillet 2008, 01:29 par 1ace
9. Le jeudi 24 juillet 2008, 05:22 par rpelisse
10. Le jeudi 24 juillet 2008, 09:33 par manatlan
11. Le jeudi 24 juillet 2008, 10:35 par Julien
12. Le jeudi 24 juillet 2008, 10:36 par heyheymymy
13. Le jeudi 24 juillet 2008, 10:46 par NiKo
14. Le jeudi 24 juillet 2008, 10:49 par No'
15. Le jeudi 24 juillet 2008, 11:10 par neolao
16. Le jeudi 24 juillet 2008, 11:26 par Pierre
17. Le jeudi 24 juillet 2008, 11:33 par NiKo
18. Le jeudi 24 juillet 2008, 11:37 par Pierre
19. Le jeudi 24 juillet 2008, 11:39 par Pierre
20. Le jeudi 24 juillet 2008, 11:42 par NiKo
21. Le jeudi 24 juillet 2008, 13:14 par Romain Dorgueil
22. Le jeudi 24 juillet 2008, 16:37 par thibault
23. Le jeudi 24 juillet 2008, 16:48 par NiKo
24. Le jeudi 24 juillet 2008, 18:04 par 1ace
25. Le jeudi 24 juillet 2008, 22:05 par NiCoS
26. Le jeudi 24 juillet 2008, 23:24 par arnod'mental
27. Le vendredi 25 juillet 2008, 07:47 par NiKo
28. Le vendredi 1 août 2008, 23:51 par On est normand ou on l'est pas
29. Le vendredi 8 août 2008, 11:26 par Max