Discussion :

[berceker united]

Bonjour
Actuellement je suis sur un projet qui sera gratuit et les sources seront visible. Dans ma stratégie je souhaite donner un maximum d'information concernant l'application c'est à dire. Toute la doc objet via phpdocumentor. Model de données, explication précis sur certain élément, FAQ complete. Bref je veux limite que le developpeur se sente à l'aise. Néanmoins, je me pose la question que beaucoup d'application gratuite et ouvert ne sont pas très bavard coté doc. Mise à part comment faire ceci cela mais lorsqu'il y a des modif à fair il faut retrousser ses manches et fourrer son nez pour comprendre et dans mon idée de départ je souhaitais éviter cette étape et que je puisse l'expliquer avant toute chose. Y a t'il une raison à ce que certain soit peut bavard sur ça ? L'envie qu'il y en ait que ne puisse pas trop pomper le code ? ou autre?
Mon idée de départ c'est que je ne veux pas que le mec galère pour comprendre la logique. Malgré que je fasse les choses proprement et dans une certaine logique.

[maximenet]

utilise tu le modele MVC ? un framework déjà existant ?
Où te sert tu de ta propre logique ? auquel cas il sera déjà peut etre plus difficile d'y fourré son nez

[berceker united]

utilise tu le modele MVC ? un framework déjà existant ?
Où te sert tu de ta propre logique ? auquel cas il sera déjà peut etre plus difficile d'y fourré son nez

Je n'utilise pas de framework existante et c'est sur ma propre logique dont je pense qu'il il faut avoir un certain niveau en objet pour comprendre la logique de l'application.

[maximenet]

euhhh ... bé justement, faire de l'objet ne veux pas forcément dire architecture de code propre et logique.

M'enfin je suis sur que tu sera nous faire quelque chose de bien présenté, maintenant perso je ne serai te dire pourquoi certains ont du mal avec l'aidre qu'ils apportent à leur logiciel open source, peut etre parce que çà demande du temps aussi

[wamania]

Salut

Les prog comme phpDocumentator, javadoc ou doxygen ont été ecrit pour palier le manque de document des développeurs, mais je crois que c'est plus un moyen de s'affranchir de quelque chose de pompeux.
Au final, je dirais qu'une doc style javadoc est utile à 20% de la compréhension d'un script.

Si on a inventé de la paperasse lourde (spécification fonctionnelle, opérationnelle, cahier des charges, manuel développeur, manuel utilisateur, rapport de tests....), c'est qu'il y a une demande pour cette doc.

Bref, mes docs à moi sont presque toujours quelques pages synthétisant ce que je veux faire, ce que j'utilise, comment j'ai découpé mes blocs fonctionnels....plutôt qu'un paquet de fonction et de classe.

Cependant, certains groupes, dont PEAR utilise la génération de doc automatique et ont des docs très riche, mais leur fichier PHP contient en gros 2/3 de commentaires, ce que je trouve soulant personnellement.

[berceker united]

Salut

Les prog comme phpDocumentator, javadoc ou doxygen ont été ecrit pour palier le manque de document des développeurs, mais je crois que c'est plus un moyen de s'affranchir de quelque chose de pompeux.
Au final, je dirais qu'une doc style javadoc est utile à 20% de la compréhension d'un script.

Si on a inventé de la paperasse lourde (spécification fonctionnelle, opérationnelle, cahier des charges, manuel développeur, manuel utilisateur, rapport de tests....), c'est qu'il y a une demande pour cette doc.

Bref, mes docs à moi sont presque toujours quelques pages synthétisant ce que je veux faire, ce que j'utilise, comment j'ai découpé mes blocs fonctionnels....plutôt qu'un paquet de fonction et de classe.

Cependant, certains groupes, dont PEAR utilise la génération de doc automatique et ont des docs très riche, mais leur fichier PHP contient en gros 2/3 de commentaires, ce que je trouve soulant personnellement.

C'est le dernier point que je veux éviter. Bien souvent le commentaire est compréhensible pour celui qui l'a développé.

[berceker united]

euhhh ... bé justement, faire de l'objet ne veux pas forcément dire architecture de code propre et logique.

M'enfin je suis sur que tu sera nous faire quelque chose de bien présenté, maintenant perso je ne serai te dire pourquoi certains ont du mal avec l'aidre qu'ils apportent à leur logiciel open source, peut etre parce que çà demande du temps aussi

Je suis bien daccord avec le premier point car j'ai déjà subit ceux qui pensait avec cette logique et je devais travailler avec leur merde et c'est justement pour avoir subit ça que je ne souhaite faire la même chose au autre. J'en avait marre de chercher comment il fonctionnaient aussi bien dans OSCommerce, Spip, PhpBb. Je souhaite pas faire du code "Pure énergie" mais qu'ils comprennent dans quel logique que ça été fait donc en donnant un maximum d'information. Une doc complete. Je me force à tous commenter avec les balises phpdoc. Schéma, Dessin, Dossier, etc...

[ePoX]

...Y a t'il une raison à ce que certain soit peut bavard sur ça ? L'envie qu'il y en ait que ne puisse pas trop pomper le code ? ou autre?....

Aucune idée.

..... Je suis pas l'abbé Pierre du dev.

Pourtant j'ai cru... Si tu veux faire de l'open source tu devras bien te faire à l'idée que tu auras des gens qui vont te pomper, faire du fric sur ton appli, et d'autres qui au contraire auront ta démarche et en feront profiter le projet.

Faut pas trop réver à ce niveau la d'après moi.

[berceker united]

Aucune idée.


Pourtant j'ai cru... Si tu veux faire de l'open source tu devras bien te faire à l'idée que tu auras des gens qui vont te pomper, faire du fric sur ton appli, et d'autres qui au contraire auront ta démarche et en feront profiter le projet.

Faut pas trop réver à ce niveau la d'après moi.

En faite, je voulais dire par là que le code est ouvert mais je n'expliquerais pas comment j'ai fais telle ou telle chose en précision. J'expliquerais seulement comment arriver à ce resultat. J'ai prévus aussi de livrer seulement la source non commenté dans les fichiers.

[ePoX]

....J'expliquerais seulement comment arriver à ce resultat. J'ai prévus aussi de livrer seulement la source non commenté dans les fichiers.

Moi ce que je ne comprend pas la, c'est que la valeur de ton appli elle se situe dans les possibilités qu'à l'utilisateur final, ou le développeur final.
Pas dans les lignes de codes qui servent à produire ce résultat.

Et je ne pense pas que tu ais révolutionné les méthodes de développement à un point que tu ais besoin de *protéger* les basements de l'appli en ne les commentant pas. Je dirais même au contraire, fais en profiter la communauté pour que celle ci en sorte grandissante, et ton appli aussi. Plus simple elle sera à appréhender, plus tu augmenteras tes chances de rassembler autour de ton projet une communauté dédié.
Et cette communauté bien driver saura faire évoluer ton appli dans la meilleure des voie.

non ?

[berceker united]

Je crois que je me suis un peut mal expliqué. Je veux pas faire le radin je voulais dire que les commentaires ne seront pas là pour expliquer chaque bout de code que je fais. Comme c'est entierement objet le commentaire seront transposé via phpdoc. Avant d'expliqué le code je préfère expliquer comment le tous s'articule après le code en lui même n'a rien de révolutionnaire. Quand je disais que je ne suis pas l'abbé pierre du dev c'est dans le sens ou je ne vais pas expliquer comment je fais pour le lire le contenu d'un répertoire.

[ePoX]

Ah oué... mais la sa relève du bon sens et des capacités de lecture du développeur mdr