noalyss Version-9
Francais

Introduction

Cette partie contient de la documentation pour les développeurs.

Convention de codage

Quelques conventions de codage pour avoir un code plus ou moins homogène

  1. Tant que possible réutiliser ce qui existe déjà,
  2. Améliorer ce qui existe déjà et vérifier que cela fonctionne toujours
  3. Documenter avec les tags doxygen votre nouveau code,
  4. Dans le répertoire include: Les noms de fichiers sont *.inc.php pour les fichiers à exécuter
  5. Dans le répertoire include: Les noms de fichiers sont *.php pour les fichiers contenant des fonctions uniquement
  6. Dans le répertoire include: Les noms de fichier sont class_*.php pour les fichiers contenant des classes.
  7. Dans le répertoire include: Les noms de fichier ajax* correspondent aux fichiers appelé par une fonction javascript en ajax, normalement le nom de fichier est basé sur le nom de la fonction javascript exemple pour la fonction javascript anc_key_choice le fichier correspondant est ajax/ajax_anc_key_choice.php
  8. Dans le répertoire include/template: les fichiers de présentation HTML
  9. Utiliser sql/upgrade.sql comme fichier temporaire pour modifier la base de données, en général ce fichier deviendra l'un des patch
  10. Faire de la doc

Conseils

Utiliser cette documentation, elle est générée automatiquement avec Doxygen,

  • Related contient tous les \todo
  • Global -> function pour lire toute la doc sur les fonctions
  • Regarder dans dossier1.html et account_repository.html pour la doc des base de données

et il ne faut connaître que ces tags

  • \file en début de fichier
  • \todo ajouter un todo
  • \enum pour commenter une variable
  • \param pour commenter le paramètre d'une fonction
  • \brief Commentaire du fichier, de la fonction ou de la classe
  • \note des notes, des exemples
  • \throw or exception is a function can throw an exception
  • \par to create a new paragraph
  • \return ce que la fonction retourne
  • \code et \endcode si on veut donner un morceau de code comme documentation
  • \verbatim et \endverbatim si on veut donner une description d'un tableau, comme documentation
  • \see xxxx Ajoute un lien vers un fichier, une fonction ou une classe

</ul>