Quelques règles simples vous permettent de livrer du code aussi pur que possible. Avec cela en tête, mes conventions de code sont les suivantes :
Imitez la présentation du code...
Pour ceux qui recherchent une convention de codage, je viens de tomber sur une proposition draft de Régis Gaidot, disponible sur son site.
Les conventions de codage permettent d'uniformiser un programme, et de le comprendre plus facilement. Par exemple, si toutes les constantes sont en majuscules, il sera facile de les répérer dans le projet, même si vous n'avez pas écrit la partie de code que vous lisez. Les conventions de codage permettent aussi d'améliorer la sécurité en mettant en valeur les variables sécuritaires des variables entrantes.
Le plus important avec des conventions de codage, c'est de les suivre. Le reste est affaire de gout.
Joel On Software a un magnifique article sur la propreté du code. Il aborde ainsi la perception même du code propre (qu'est-ce qui est propre? qu'est ce qui ne l'est pas), puis les conventions de codage et la notation hongroise. Rien de tout cela n'est spécifique à PHP, mais tout y est applicable. Un bon (et long) moment de lecture.
Robert Peake produit un article dans lequel il explique que PHP devrait se parer d'un atout sérieux pour assurer sa progression en entreprise : les conventions de codage. Il s'agit de permettre à un manager de comprendre et aimer le code dès la première rencontre.
Un article plus détaillé paraîtra dans le prochaine PHP-Magazine international (version anglaise), mais Robert livre déjà les conseils de base :
+ Utilisez PHPDocumentor pour documenter toutes les fonctions et classes
+ Séparez le code du contenu (HTML)
+ Séparez le contenu de la présentation (CSS)
Plusieurs liens sont donnés en référence.
Les méthodes agiles peuvent-elles être mises en œuvre sur des projets d'architecture d'entreprise ? Faut-il s'en inspirer ou les appliquer à la lettre ? Pistes de réflexion.
Les projets agiles ne cessent de mettre en exergue la productivité des développeurs sur la base du nombre de lignes de code produit. Dans ce billet, Udi Dahan montre que toute estimation individuelle ne peut être que biaisée car l'effort d'un développeur est surtout encouragée par l'effort d'une équipe. A lire.
Le Genre dans
les Conventions de RIO
Les
Conventions des Nations unies sur la biodiversité, sur les changements
climatiques (UNFCCC) et sur la lutte contre la désertification (UNCCD) ; connues sous
l'appellation de " Conventions de Rio " (...)
Robert Peake publie un long monoblogue de 3 articles consacré aux standards de codage. Les standards de codage diffèrent des conventions de code, qui organisent les instructions dans un script. Un standard de codage correspond à une organisation générale d'une application, pour permettre une paralellisation des tâches en plusieurs sous-groupe. La répartition classique est celle que présente Robert :
+ Documentation automatique
+ Séparation du code de la présentation
+ Séparation du code et du contenu
Dans ce billet, Patrick Smacchia répond à Jeremy Miller, bloggueur prolixe du site codebetter.com, auteur de l'outil StructureMap et fervent partisan des architectures dites "agiles". Dans un message twitter, Jeremy Miller affirme ne pas voir d'intérêt dans les outils d'analyse de dépendance tels que NDepend lorsqu'on maîtrise suffisamment les contours de son code. Ce à quoi Patrick a répondu par une analyse de code de StructureMap. Réponse du berger à la bergère avec en prime une belle explication de texte :-). Dans son domaine, NDepend est un outil incontournable.
Didier Girard organise une journée sur le thème de l'agilité : "Durant cet conférence, des praticiens issus d'équipes de développement où les méthodes agiles sont mises en oeuvre viendront faire des retours d'expérience et partager le plaisir qu'ils ont à intervenir sur ces projets. ". L'inscription est gratuite et le contenu très riche ...
Une quinzaine de conventions conclues à cet effet.En vertu d'une quinzaine de conventions conclues hier, à Tunis, les banques s'engagent à mieux encadrer les entreprises qui opèrent dans les secteurs de l'industrie et de l'agriculture. Ces conventions, appelées également conventions de «cogestion», ont pour objectif d'impliquer davantage les établissements de crédit dans la gestion des pépinières d'entreprises ( vice-présidence au comité de pilotage, choix du coach, sélection des projets d'idées ).
C’est au tour de Michael Shanks de rejoindre la tournée officielle des conventions Stargate aux USA ...
Celles et ceux qui me lisent depuis un certains temps, notamment sur des sujets liés à l’ergonomie et à la conception d’interfaces web, savent à quel point j’insiste sur les conventions (liens soulignés bleus…) et les risques liés au non-respect de ces conventions. Bon… vous pourriez me dire qu’il y a convention et convention mais [...]
Celles et ceux qui me lisent depuis un certains temps, notamment sur des sujets liés à l’ergonomie et à la conception d’interfaces web, savent à quel point j’insiste sur les conventions (liens soulignés bleus…) et les risques liés au non-respect de ces conventions. Bon… vous pourriez me dire qu’il y a convention et convention mais [...]
Les singes aussi peuvent apprendre des conventions sociales et les transmettre. Encore une idée reçue sur les spécificités de l'Homme qui tombe. ...
