Bonnes pratiques pour le développement

Un article de Haypo.

(Différences entre les versions)
Version du 7 avril 2008 à 10:15 (modifier)
Haypo (Discuter | Contributions)

← Différence précédente
Version du 28 mai 2008 à 15:00 (modifier) (défaire)
Haypo (Discuter | Contributions)

Différence suivante →
Ligne 1 : Ligne 1 :
[[Catégorie:Programmation web]] [[Catégorie:Programmation web]]
{{Retour|Programmation|Retour à la programmation}} {{Retour|Programmation|Retour à la programmation}}
 +
 +[[Image:Wtfm.jpg|framed|right|The only valid measurement of code quality: WTFs/minute]]
Cette page liste des bonnes pratiques pour le développement de logiciel. La première version est issue d'[https://linuxfr.org/~pap_furax/23503.html un journal linuxfr de ''Papa Furax'']. Cette page liste des bonnes pratiques pour le développement de logiciel. La première version est issue d'[https://linuxfr.org/~pap_furax/23503.html un journal linuxfr de ''Papa Furax''].

Version du 28 mai 2008 à 15:00

Retour à la page précédente Retour à la programmation

The only valid measurement of code quality: WTFs/minute
The only valid measurement of code quality: WTFs/minute

Cette page liste des bonnes pratiques pour le développement de logiciel. La première version est issue d'un journal linuxfr de Papa Furax.

  • Utiliser un gestionnaire de version du code source (ex: Subversion)
  • Automatiser un maximum de chose, exemples :
    • Lancer automatiquement des tests (« tests unitaires »)
    • Générer la documentation à partir du code source
    • etc.
  • Activer la détection de tous les avertissements (ex: avec gcc, utiliser -Wall -Wextra voire -Werror) et surtout les corriger
    • Voir également utiliser des outils dédiés : splint et Valgrind (langage C), pylint et pychecker (Python), etc.
  • Indenter le code source
  • Ne pas écrire de fonction de plus de 300 lignes
    • Si une fonction est plus longue, on peut forcément la redécouper
  • Limiter le nombre d'arguments d'une fonction (ex: 5 maximum)
  • Écrire de la documentation
  • Écrire des tests (tests unitaires, tests fonctionnels, fuzzing, etc.)
  • Utiliser des conventions de : nommage des variables, fonctions, classes et constantes, langue du code source (l'anglais pour un logiciel libre, si vous souhaitez recevoir des contributions...)
  • Éviter la redondance : factoriser le code, réutiliser du code, recherche les bibliothèques existantes avant de réinventer la roue

Autres bonnes pratiques :

  • Utiliser un outil de gestion des bogues