Plop !

A force d'analyser le code FSB2, je trouve qu'il serait beaucoup plus pratique de faire une documentation du code au style PHPDocumentor (comme le fait phpBB, par exemple), plutôt qu'un Wiki, qui lui, détaille plutôt l'utilisation du code.

Poruquoi ? Comme ca, on a une documentation précise de chaque fonctions / class / methodes / ¨propriétés et leur différentes liaisons, et ca nous évite de devoir chercher dans le wiki toutes les infos sur comment utiliser telle ou telle particularités du code, et ce, juste ne changeant la syntaxe des commentaires de ceux-ci dans le code. Comme celui-ci est plutôt avancé (dans le sens ou y'a pas mal de trucs), c'est là que vient le terme "chiant" pour la suggestion (je l'ai essayé, pour un code moins important, et c'était plutôt... chiant =D).

C'est fait à l'aide du logiciel PHPDocumentor, et après, je trouve que ca rend bien. Vous pouvez me chasser à coup de balai si vous le voulez, mais voilà, ma suggestion chiante est postée =D

Trop de modif à faire, pour une utilisation assez limite je trouve.

Moui ce serait plus pour ceux qui font les mods en gros... 'Fin bref, c'est chiant à le faire, je le sais bien =D

(Au pire, engager un toutou pour tout faire xD)

déjà suggéré il y a longtemps,
geno m'as dit non...

il trouvait cela trop compliqué à mettre en place ...
alors que une doc est si simple à consulter

Ok, lorsque la RC5 sortira je vous laisserai tout le loisir de modifier les commentaires des dizaines de fichiers et des centaines de méthodes, si vous vous voulez le faire ya pas de soucis

C'est vrai que ce serai des plus pratique…

Edit: C'est pas simple de commenter le code d'un autre... déjà que prendre la suite même avec des commentaires et bien fait c'est rarement simple.

Ben disons que les commentaires des méthodes sont assez proches de phpdoc, y'a juste des trucs à adapter (donc rien à comprendre )

Va falloir aussi corriger les fautes d'orthographe du code aussi

Je pense qu'il y a d'autres priorités

J'ai deja essaye de m'y coller mais bon seul c'etait mission impossible ...

EDIT : Sinon grummfy m'avait dit que doxygen prenait en compte les commentaires style C ou C++ me rappelle plus, donc si quelqu'un pouvait essayer.

Bah, on verra bien à la RC5 (genre se partager le boulot ).

Sinon, pour doxygen, pas essayé.. (et flemme de le faire surtout). Que ce soit soit des commentaires C/C++, ou bien autres, ce sera le même travail je pense...

non je veux dire essayer d'utiliser doxygen avec ce qui existe deja comme commentaires dans les sources.

J'avoue franchement que passer toute une journée à réécrire les commentaires pour les rendre compatible avec PHPDocumentor, pour sortir une documentation à l'intéret douteux ça me botte pas, mais alors pas du tout.
Surtout que PHPDocumentor ça ne fait que lister de façon un peu plus joli les classes. Sachant que les classes de FSB sont organisées de manières très compréhensible, il suffit simplement de regarder le dossier main/class/ pour trouver ce qu'on veut.

geno, on sais que tu n'y trouve pas d'intéret, je pense que la communauté s'arrangera pour le faire d'une manière ou d'une autre!

pourquoi ne pas se concentrer sur le wiki plutot ?