noalyss Version-9
English

Introduction

This parts contains documentation for developpers

Convention de codage

Some coding conventions to have a homogeneous code

  1. Reuse the existing code ,
  2. Improve and test that the function is still working
  3. Make documentation thanks doxygen tag
  4. In the folder include: filenames ending by *.inc.php will be executer after being included
  5. In the folder include: filenames end by *.php if they contains only function
  6. In the folder include: filenames starting with class_*.php if it is related to a class.
  7. In the folder include, files starting with ajax are executed by ajax call, usually, the file name is based on the javascript function, example for the javascript function anc_key_choice the corresponding file is ajax/ajax_anc_key_choice.php

  8. In the folder include/template: files for the HTML presentation
  9. Use sql/upgrade.sql as temporary file to modify the database,this file will be the base for a SQL patch
  10. Write documentation

Advices

Use this document, it is generated automatically by doxygen, check the documentation your made, read it first this documentation before making changes

  • Related contains all the \todo
  • Global -> all the functions
  • check into mod1.html and account_repository.html for the database design

You need to know only these tags

  • \file in the beginning of a file
  • \todo add a todo
  • \enum comment a variable
  • \param about the parameter of a function
  • \brief Documentation of the file, function or class
  • \note note exemple
  • \throw or exception is a function can throw an exception
  • \par to create a new paragraph
  • \return what the function returns
  • \code and \endcode code snippet given as example
  • \verbatim and \endverbatim if we want to keep the formatting without transformation
  • \see xxxx create a link to the file, function or object xxxx