Marc Lebas a écrit :
> Stephane LAURENT wrote:
>> Marc Lebas a écrit :
>>> RB a écrit :
>>> C'est une bonne question. Aujourd'hui les Plugins posent 3 problèmes :
>>>
>>> - documentation
>> on recrute ...
>> les wikis sont fait pour ca
> 
> J'ai l'impression que les auteurs de Plugins attendent que d'autres 
> écrivent leur doc et ta réponse le confirme. C'est peut-être ça le 
> problème de la doc, ne crois tu pas ? 

En ce qui me concerne, je developpe pour ma pomme et en général, je sais 
me servir de ce que je fabrique.
Comme je suis gentil (des fois), je prend le temps de mettre ca en ligne 
avec, quand j'ai le temps, quelques explications.
=> je me couche à 4h du mat au lieu de 2.

Je ne le fais pas pour la gloire, mais parce que si quelqu'un d'autre 
l'utilise, il peut m'aider à l'ameliorer, à lever des bugs ...
Donc si je documente, c'est uniquement pour faire grossir la masse 
d'utilisateurs.
conclusion : moins c'est documenté, moins la démarche est "interessée"

Alors pour repondre franchement, je developpe des trucs compliqués et je 
trouve ca largement suffisant.
Faire de la doc me gonfle et je ne le fais que dans un cadre professionnel.

D'un autre coté, quand je developpe un truc dans un cadre professionnel, 
je n'ai aucun interet à le garder pour moi (certains le pense, je n'en 
fais pas parti) : je pose donc ca sur le SVN de la zone et je ne prend 
pas forcement la peine de le signaler.
Si ca peut aider qqun, tant mieux, sinon, je pense que personne ne m'en 
veut d'avoir occuper 50ko sur le serveur.

> L'autre problème c'est que le 
> cadre de la doc n'est pas clair : Wiki ou site Spip (Spip-contrib au 
> hazard) ? zip dans l'article ou pas ?

Ca par contre, ca a été dit : une page du wiki pour chaque plugin pour 
la redaction.
Après, quand la "contrib" sort (sur spip-contrib ou ailleurs), ca 
devient le lieu de reference pour echanger (forum sous l'article par 
exemple)
Pour prendre l'exemple de spipcarto, il y a un projet ouvert sur 
berlios.de avec la gestion de bug et les version telechargeables.
Le plugin se developpe sur spip-zone parce que c'est plus simple pour 
tout le monde, mais la V1 etait sur le CVS de berlios.
Avant, je mettais l'article de spipcontrib à jour, mais depuis un bon 
moment, je ne peux plus le faire.

> 
> On pourrait mentionner l'aspect confiance: pour moi les Plugins sont 
> loin d'inspirer le niveau de confiance qu'inspire Spip.

Chacun a le droit d'avoir son opinion et surtout, personne n'est obligé 
d'utiliser.
Tu devrais relire la GPL ... que ca soit Spip ou les plugins, c'est 
livré sans garantie.
C'est gratos, mais si ca fait exploser ton serveur ou te fait perdre 
toutes tes données, c'est pas la peine de venir te plaindre, c'est ca le 
deal.

> La quasi absence 
> de doc. n'aide pas à construire cette confiance ni ne facilite 
> l'établissement d'un cadre de maintenance.

Tu me fais rire !
Perso, ca ne me fait ni chaud ni froid que les utilisateurs tremblent en 
installant spipcarto.
Si ils en ont besoin, ils peuvent l'utiliser, c'est tout.
Si ils n'ont pas confiance, ils n'ont qu'à aller voir ailleurs : moi je 
l'utilise et j'ai confiance, ca me suffit.

Après, si ca rentre dans un cadre professionnel, c'est autre chose.
Mais encore une fois, je risque pas de faire la doc de mes plugins juste 
pour la gloire.
Le developpement "libre", c'est pour moi une demarche collaborative ou 
chacun apporte ce qu'il peut.
J'ai les competences pour developper, je le fais et encore une fois, 
j'en attend meme pas un merci, c'est plutot l'inverse : je dis merci 
quand me fait remonter des infos.
Maintenant, les "consommateurs", la moindre des choses, c'est qu'il 
fasse ce qui est à la portée de tous et qui les interessent : la doc.
Car encore une fois, moi, j'en ai pas besoin.

>  > compatibilité entre avec le core, c'est simple : il y a les plugins
>  > stables, ceux pour la 1.9.0 et ceux pour la 1.9.1
> 
> 
> Quand Spip est stable, il sort avec une doc. Les Plugins feraient-ils 
> exception ? 

Parce que tu crois que c'est Fil ou ESJ qui se tapent la doc ?

> Pour moi un Plugin sans doc. peut rester dans sa zone de 
> fabrication.

Avec ce genre de reflexions, ils risquent effectivement d'y rester, voir 
  de ne meme plus y aller !

Pfouuuu, si Jacques n'avait pas posté son astuce du jour, je crois que 
je me serais désabonné aujourd'hui !

@++

PS : Faut absolument sortir une version payante de spip pour que les 
emmerdeurs puissent aller raler auprès d'un service client : ca nous 
fera des vacances !!!