diff --git a/lang/fr/docs/coding.html b/lang/fr/docs/coding.html index c0e2c2cbbdf..76e2fd58d23 100755 --- a/lang/fr/docs/coding.html +++ b/lang/fr/docs/coding.html @@ -110,16 +110,27 @@ $var = "some $text with $many variables $within it";

-
  • Les commentaires doivent utiliser deux ou trois barres obliques et être alignés avec le code. -

    function forum_get_ratings_mean($postid, +

  • Les commentaires doivent être ajoutés autant que possible, dans le but d'expliciter le fonctionnement du code et le pourquoi des fonctions et variables. + +

    + /**
    + * La description doit apparaître d'abord, avec des astérisques positionnés
    + * exactement comme dans cet exemple. Pour vous référer à une autre fonction,
    + * utiliser cette syntaxe : {@link clean_param()}. Après la description de la
    + * fonction, ajouter celle de chacun des paramètre de la façon suivante.
    + *
    + * @param int $postid Le type PHP est suivi du nom de la variable
    + * @param array $scale Le type PHP est suivi du nom de la variable
    + * @param array $ratings Le type PHP est suivi du nom de la variable
    + * @return mixed
    + */
    +function forum_get_ratings_mean($postid, $scale, $ratings=NULL) - {
    -     /// Return the mean rating of a post given - to the current user by others.
    - /// Scale is an array of possible ratings in the scale
    - /// Ratings is an optional simple array of actual ratings (just integers)
    -
    -         if (!$ratings) + {
     +     if (!$ratings) {
                $ratings = array();     //