zestedesavoir/zds-site — pull request #1945 by SpaceFox (2014-12-21 01:32:18+00:00)
Title: Ajout de commentaires et remarques sur le module des forums

# Travail en cours, commentez mais ne mergez pas !

| Q | R
| ------------------------- | -------------------------------------------
| Correction de bugs ? | Non
| Nouvelle Fonctionnalité ? | Non
| Tickets concernés | Il me semblait qu'il y en avait un mais je ne l'ai pas retrouvé...

Le but de cette PR est de rajouter des commentaires, qui manquent énormément dans le code.

Lors de mes pérégrinations, j'ai aussi trouvé un certain nombre de bizarreries, ici signalées par des TODO, parce que ce n'est pas le but de la PR de les corriger et que certaines ne méritent probablement même pas une issue.

Pour l'instant il n'y a que le module de forums.

**Ce qui m'intéresse pour l'instant :**

1. Est-ce que ça vous paraît bien ?
2. Comment générer une doc avec ces commentaires ?
3. Est-ce que le niveau de détail des commentaires vous paraît bon ?
4. Est-ce qu'il n'y a pas trop d'horribles horreurs d'anglais ?