Guidelines
Des rĂšgles Ă suivre pour tout projet !
Principes généraux
- Tous les fichiers sont encodés en utf-8 sans BOM.
- Corriger un fichier ou un bout de code qui ne respecte pas les conventions nâest jamais une perte de temps.
- Indentez proprement. SĂ©rieusement.
- Les commentaires sont importants, mais il faut commenter intelligemment : un commentaire inutile prend de la place pour rien.
- On se dĂ©cide pour une langue : on nomme toutes ses variables / classes en anglais ou en français (et, si possible, les commentaires aussi), et on sây tient : on ne jongle pas dâune langue Ă lâautre.
- Les TODO sont conseilleÌs, mais il faut les deÌtailler : rien ne dit que câest vous qui repasserez dessus.
KISS: Keep It Simple, Stupid!
La simplicitĂ© est la sophistication suprĂȘme : un code simple est plus lisible et plus facile Ă maintenir.
DRY: Donât repeat yourself
Si la mĂȘme portion de code se retrouve deux fois ou plus dans un script, on en fait une fonction. Si la mĂȘme portion de code se retrouve deux fois ou plus dans une classe, on en fait une mĂ©thode.
YAGNI: You arenât gonna need it
Rien ne sert de coder une mĂ©thode qui nâa pas dâimplĂ©mentation ou dâutilitĂ© immĂ©diate.
Donât be shy, ask!
Il nây a pas de honte Ă demander de lâaide, surtout avant dâattaquer une nouvelle fonctionnalitĂ©.
Guidelines pour HTML
Guidelines pour CSS (et préprocesseurs)
Guidelines pour Javascript
Guidelines pour Photoshop / Illustrator
Guidelines pour de bons Ă©changes client / prestataire
Crédits
Ces rĂšgles ont Ă©tĂ© fortement inspirĂ©es du travail de RaphaĂ«l Goetter, Pierre-Antoine Delnatte, Christophe Porteneuve, âŠ