La doc spip ne suit pas le développement. C'est toujours le même pb. Pour la version 1.9, il faut aller chercher un peu partout pour trouver une info...
Je suggère 2 méthodes :
- Soit ouvrir la doc spip sur www.spip.net aux commentaires, comme la doc PHP. Il faudra des admins pour accepter ou refuser les commentaires. Et évidemment la majorité des contributions sera en français, donc inaccessible aux non francophones, à moins que le contributeur veuille bien traduire son commentaire. De plus on pourra périodiquement mettre à jour chaque article de la doc en piochant dans les commentaires.
- Soit faire une doc sur le modèle de wikipédia.
cela faisait longtemps que je ne t'avais lu je viens (gentiment) te contredire.
La doc spip ne suit pas le développement. C'est toujours le même pb.
C'est vache ce que tu dis : pour une fois il y avait eut un effort de fait de ce côté là et c'était (je trouve) sensible. Mais c'est sûr que la 1.9 a bouleversé bien des choses et que des tas de détails restent à préciser.
Pour la version 1.9, il faut aller chercher un peu partout pour trouver
une info...
Je suggère 2 méthodes :
- Soit ouvrir la doc spip sur www.spip.net aux commentaires, comme la
doc PHP. Il faudra des admins pour accepter ou refuser les commentaires.
Et évidemment la majorité des contributions sera en français, donc
inaccessible aux non francophones, à moins que le contributeur veuille
bien traduire son commentaire. De plus on pourra périodiquement mettre à
jour chaque article de la doc en piochant dans les commentaires.
La doc de spip EST ouverte : à la rédaction, à la modification, à la traduction et mêmes aux commentaires sur l'espace privé.
C'est un site sous spip : pas une doc php ni un wiki.
Les sites sous spip ont un workflow que nous connaissons tous : il faut l'utiliser.
- Soit faire une doc sur le modèle de wikipédia.
dans spip 2.0 : peut-être prévoir un workflow modifiable? (on en revient à la question des droits modulables).
En attendant, j'invite tous ceux qui trouvent la doc incomplète à venir la compléter sur spip.net de manière à ce que ce reproche soit de plus en plus faux : BMR, si la doc de spip est incomplète c'est autant ta faute que la mienne
En attendant, j'invite tous ceux qui trouvent la doc incomplète à venir la compléter sur spip.net de manière à ce que ce reproche soit de plus en plus faux : BMR, si la doc de spip est incomplète c'est autant ta faute que la mienne
oui mais l'écriture de doc est souvent soumise à une connaissance profonde du code, la seule chose en tant l'utilisateur lambda je puisse faire c'est de remplir une rubrique type "trucs et astuces" ou de compléter la doc par des exemples concrets mais la doc de base doit être la plus complète possible
La doc spip ne suit pas le développement. C'est toujours le même pb. Pour la version 1.9, il faut aller chercher un peu partout pour trouver une info...
Pour la doc développeur, c'est d'accord : elle est un peu partout ou n'existe pas du tout : c'est selon le sujet.
Pour la doc utilisateur, il y a la doc de base (spip.net), Spip-contrib, Spikini , Spip-zone. Dans le chaos, la doc de base me semble un repère solide, bref pas si mal fait que çà.
Bonjour toubib ! ainsi que ceux qui m'ont répondu...
Oui, j'ai un peu lâché spip, mais le spipeur revient toujours sur les
lieux de son forfait. D'où mon désarroi en revenant avec cette nouvelle
version (entre () géniale) qui change mal de choses en bien.
Tu as bien raison de dire que si la doc n'est pas à jour, j'y suis pour
qqch à mon niveau. Mais je ne vois pas comment faire, à moins d'adresser
une série de mails de mises à jour à un quidam, qui est peut-être en
vacances ou qui a probablement autre chose à faire dans l'immédiat...
D'où ma suggestion d'ouvrir la doc aux commentaires sur le modèle de la
doc php, ce qui devrait être relativement simple à faire pour un site
spip. En attendant de trouver quelque chose de plus élaboré.
je viens (gentiment) te contredire.