Johan Cwiklinski a écrit :
Stéphane Aulery a écrit :
J'ai quelques questions :
- Y-a-t-il des conventions de codage précises, des règles de
développement à appliquer au projet (commit, bug, log, todo, ...) ?
Il n'y a pas de règle de développement particulières. Pour les
conventions de codage, le code actuel n'en respecte pas vraiment, mais
il serait bien que nous tendions à respecter celles de PEAR, ainsi que
les commentaires pour sortir la doc. Ces sujets avaient été abordés sur
la liste il y a quelque temps (par John P. si ma mémoire est bonne).
Oui, c'était une suggestion de réponse à cette même question. Utiliser
les règles PEAR a AMA 2 avantages:
-Elles sont déjà écrites
-Elles prennent en compte la documentation intégrée comme phpdoc
De plus le code actuel de galette n'en est pas si éloigné ce qui fait
que l'on pourra migrer aisément vers du code conforme au fur et à mesure
des modifs sans avoir à faire trop d'efforts spécifiques dans ce sens.
Il y a aussi dans l'arboresence du trunk le répertoire docs qui contient:
1-La documentation développeur générée par phpdocumentor et qui se
visualise avec un navigateur directement en docs/index.html. Le makefile
permet de regénérer la doc quand on a mis des sources à jour.
2-Une version docbook du manuel qui existe sur le site de galette dans
le répertoirte manual.
3-Un modèles xml de base pour le système de modèle de documents que je
suis en train de développer...depuis la toussaint... Dans le répertoire
models. C'est de la version alpha pour l'instant et le modèle ne
concerne que les cartes mais sera extensible sans problèmes aux
étiquettes et tout autres sortes de documents à extraires de la base
comme les listes d'adhérents pour AG etc... Ce répertoire n'est peut
être pas vraiment à sa place là, à voir pour la v0.7.
Salutations et bienvenue dans l'équipe.
--
John Perr
GPG Id 0xA83889EC
Re: [Galette-devel] Règles de codage