Gambas 3/Gambas3LeLangage/Clean Coding

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche

Clean Coding[modifier | modifier le wikicode]

Clean Coding est de l'anglais est signifie coder propre ou proprement.

Coder proprement, quel que soit le langage informatique utilisé, vient avec l'expérience et le désir de présenter un code accessible aux autres développeurs. Ce code devra être maintenable dans le futur !

Si les autres programmeurs profèrent des jurons en lisant votre code alors votre code n'est sans doute pas clair !

Si vous n'êtes pas obligé de réécrire le code à chaque changement, il y a de bonne chance que votre code soit propre.

Bien entendu c'est une quête perpétuelle; Vous trouverez toujours un point à améliorer. À vous de sentir quand c'est suffisant.

Il faut se fixer quelques règles permettant d'atteindre cet objectif :

  • Votre code doit être agréable à lire. Indentez correctement !
  • Commentez ! Mais pas trop et n'expliquez pas ce qu'on comprend en lisant les instructions dans le code !
  • Une routine, une fonction tient sur un écran.
  • Le nom des variables est représentatif de l'objet stocké. Il n'est ni trop court, ni trop long. Suivez une convention de nommage !
  • Appliquez le principe KISS ! Keep It Simple Stupid! Une routine, une fonction ne doit faire qu'une chose.
  • Appliquez le principe DRY ! Don't Repeat yourself Factorisez le code ! Lorsque vous sentez que vous vous répétez, tentez de créer une fonction que vous pourrez appeler au lieu de vous répéter !

En cherchant sur le web, vous allez trouver des dizaines d'articles relatifs à cette thématique !