pourquoi ne pas se concentrer sur le wiki plutot ?

ben on s'y concentre...
mais ce n'est pas le même but ...

Ben le wiki, c'est plus en détails (trop de détails), alors que ca, ca permet de générer une "vraie" documentation, dans le sens ou on a accès aux classes, un exemple (si y'a besoin), et un rapide descriptif (en gros, dans le genre Doc PHP). A moins que n'ailles à chaque fois consulter une tutorial PHP concernant (par exemple) la fonction sprintf() à chaque fois que tu as besoin de jeter un oeil sur les arguments, au lieu de jeter un oeil sur la doc PHP, pour voir un rapide descriptif et la liste des arguments (et eventuellement un petit exemple)...

Ben si, puisque le Wiki sera fait à la fois pour les utilisateurs de base, et aussi pour les moddeurs. L'API de FSB2 sera expliquée dans le Wiki, ainsi que les principales classes. Ce sera donc une sorte de PHPDocumentator en mieux et plus efficace.

Ben, honnetement, je trouve que le wiki n'est pas vraiment fait pour ca... Il donne juste les trucs qu'il faut pour savoir utiliser telle ou telle fonctionnalité, mais il donne pas vraiment une documentation précise des fonctions et des classes de FSB2... Ce pourrait genre être un ajout d'un lien dans le wiki, pour un truc plus avancé (et puis en même temps, si d'autres veulent perdre leur temps à ca.. )

Bon ben do as you wish pour la documentation si vous l'estimez utile dans ce cas

EDIT : vous dites que phpBB3 utilise PHPDocumentator, mais on peut pas dire qu'ils se sont emmerdés, ils n'ont renseignés casiment aucun argument pour la plupart des fonctions.

Ui, mais ils ont quand même renseigné la structure

(Me semblait que c'etait renseigné auparavant)

Bref, raison de plus pour faire mieux

Pour moi si on compare FSB a PHP par exemple, le wiki c'est les tutos de developpez, du site du zero etc., et la doc c'est php.net

C'est pas un tres bon exemple mais c'est a peu pres ca. Mais bon on s'arrangera a la sortie de FSB finale

C'est ce que je disais plus haut... ^^

Euh... Tu codes pas en Java toi ? L'utilisation de la Javadoc m'a vraiment convaincu de l'utilité de ce genre de documentation que ce soit pour Java ou pour une librairie. C'est pratique, on trouve plus rapidement que dans un Wiki (c'est pas son but au wiki), et on voit plus facilement la structure, les liens qui peut y avoir entre différentes fonctions.

Perso j'ai jamais besoin eu de ça pour comprendre le code de FSB2, ça fait à peine plus de 6 mois que je joue avec FSB2, et je pense pouvoir me considérer comme faisant partie des 10 personnes qui connaissent le mieux son code...

Je veux bien croire que ça serait utile à certains, mais comme l'a dit Genova, libre à vous de mener à bien ce projet si il vous tient à coeur... Je vois pas l'intérêt d'épiloguer la dessus en fait, vous voulez un phpDocumentator, ben à la sortie de la RC5 travaillez à cela

Ben, c'est vrai que la javadoc est super utile, mais il y a une différence il me semble :

Quand tu écris un programme en java, tu pars de zero. Par contre, quand tu écris un mod, tu modifie un programme et, par conséquent, le but n'est pas de connaître les fonction qui existe mais de les modifier et, donc, de comprendre comment elle marche. Et ça, la meilleure solution, c'est de lire le code...

PHPDocumentor n'est pas (peu?) utile dans le cadre de la création de mod parce que, quoiqu'il arrive, tu devras te plonger dans le code et comprendre son fonctionnement avant de pouvoir commencer à coder ta modification. Si les module s'écrivait comme un plug'in firefox ou autre, alors effectivement se serait intéressant. Mais la, le but n'est pas d'utiliser des fonunections déjà écrite, c'est de les modifier.

Par contre, là ou PHPDocumentor serait utile, c'est pour lister les fonctions commune à toutes les classes et souvent utilisée (utilisation de la db, etc.)... Mais en tout cas, pas pour tout les objets et, donc, pas grand chose finalement. (Surtout que c'est des fonction qu'on voit partout dans le code...)

Bref, je suis de l'avis de Genova : le wiki me semble amplement suffisant à cette tâche et PHPDocumentor, trop fastidieux à "implementer" pour ce qu'il apporterait.

Maintenant, je n'ai jamais fait qu'un mod jusque maintenant, donc, je dis peut-être des conneries...

tait toi ... ou ghuntur avec un H te parlera ...

@nosmile: Non tu ne dis pas de connerie Modder sur FSB2, c'est facile, ça demande un effort pour le premier mod, après ça passe tout seul.

me disait aussi...

Je viens d'apprendre le php sur le sdz et j'ai decide de faire un site base sur FSB. je veux pas perdre 6 mois a lire le code de FSB et j'ai pas la capacite de me plonger dans le code et le comprendre comme le font les bons codeurs comme BJ. J'ai donc juste besoin de savoir quels arguments passer a la fonction qui logue un utilisateur, et quel valeur de retour attendre de celle qui liste les forums.

La solution ? le wiki ? non. Ah oui, la doc bien sur ...

Ici on ne parle pas juste de mods, de codeurs confirmes ou de personnes qui savent s'y prendre, c'est surtout au debutant que ca sert. C'est sur que les personnes qui sont constamment sur ce forum, a modder, essayer d'aider, voir et revoir le code, pourront facilement comprendre sans doc, mais les autres non. Donc moi j'en ai pas besoin, toi non plus BJ, et toi non plus nosmile, mais lui si . Faut penser a lui .