J'aimerais participer à la doc en tant que testeur de plugins, à défaut d'être capable de participer à la programmation. Je ne sais pas trop ou faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini de Spip Contrib ? Sur le wiki de Spip zone ?
un exemple : il y a dans le dossier du plugin forms un fichier lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James" qui donne un premier jet de doc et invite à le compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil du wiki une entrée spip-forms avec une ligne de descriptif et un lien vers une page dédiée ou au moins ce texte lisezmoi devrait être reproduit. Par contre, je n'ai apparemment pas la main pour créer la page. Marche autrement, ce wiki ?
Le 02/06/06, Pierre Noguer<pierre.noguer@ac-grenoble.fr> a écrit :
J'aimerais participer à la doc en tant que testeur de plugins, à défaut
d'être capable de participer à la programmation. Je ne sais pas trop ou
faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini
de Spip Contrib ? Sur le wiki de Spip zone ?
Pour les plugins, il vaut mieux à mon avis les écrire sur le wiki de Spip zone.
Le point d'entrée est Connexion · GitLab (vide pour
l'instant)
un exemple : il y a dans le dossier du plugin forms un fichier
lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
du wiki une entrée spip-forms avec une ligne de descriptif et un lien
vers une page dédiée ou au moins ce texte lisezmoi devrait être
reproduit. Par contre, je n'ai apparemment pas la main pour créer la
page. Marche autrement, ce wiki ?
Pour créer une page, il faut être authentifié. (lien du haut)
Est-ce que vous voulez que je supprime cette restriction ?
Bref, j'aiderais bien, mais comment ?? et où ?
A partir de la page LesPlugins.
Lorsque les docs seront suffisamment étoffées sur spip-zone, on les
synchronisera sur le spikini.
J'aimerais participer à la doc en tant que testeur de plugins, à défaut
d'être capable de participer à la programmation. Je ne sais pas trop ou
faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini
de Spip Contrib ? Sur le wiki de Spip zone ?
C'est un peu vrai, cet aspect des choses n'est pas vraiment au point.
un exemple : il y a dans le dossier du plugin forms un fichier
lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
du wiki une entrée spip-forms avec une ligne de descriptif et un lien
vers une page dédiée ou au moins ce texte lisezmoi devrait être
reproduit. Par contre, je n'ai apparemment pas la main pour créer la
page. Marche autrement, ce wiki ?
à priori on ne s'en sert pas. ce que tu as trouvé, ça doit être un résidu
historique de l'époque où c'était développé sur le lab... enfin je crois.
Bref, j'aiderais bien, mais comment ?? et où ?
le mieux, c'est de faire ça en deux temps :
- maïeutique : 'aider' l'auteur du plugin à expliquer le plus de choses
possibles sur cette liste
- rédaction : un artice dans la rubrique spip-zone du site
(qu'éventuellement tu administres ... )
Sachant que le zip à télécharger que proposera l'article peut être généré
automatiquement sur spip-zone et être placé en doc joint distant dans
l'article.
Après les deux mails de Gilles et James, c'est un peu plus clair, mais ...la tentative d'ouverture de page que j'avais faite était dans : http://trac.rezo.net/trac/spip-zone/wiki/LesProjets
qui est la seule page accessible de la page d'accueil :
qui parle des plugins alors que la page encore vide citée par Gilles :
n'est pas accessible de la page d'accueil.
Bref, prise de tête pour le moment
Je me suis inscrit, et effectivement, ça me donne la possibilité de créer une page, mais c'est sûr qu'il vaut mieux éviter d'en créer dans tous les coins.
James a écrit :
Pierre Noguer wrote:
J'aimerais participer à la doc en tant que testeur de plugins, à défaut
d'être capable de participer à la programmation. Je ne sais pas trop ou
faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini
de Spip Contrib ? Sur le wiki de Spip zone ?
C'est un peu vrai, cet aspect des choses n'est pas vraiment au point.
un exemple : il y a dans le dossier du plugin forms un fichier
lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
du wiki une entrée spip-forms avec une ligne de descriptif et un lien
vers une page dédiée ou au moins ce texte lisezmoi devrait être
reproduit. Par contre, je n'ai apparemment pas la main pour créer la
page. Marche autrement, ce wiki ?
à priori on ne s'en sert pas. ce que tu as trouvé, ça doit être un résidu
historique de l'époque où c'était développé sur le lab... enfin je crois.
Bref, j'aiderais bien, mais comment ?? et où ?
le mieux, c'est de faire ça en deux temps :
- maïeutique : 'aider' l'auteur du plugin à expliquer le plus de choses
possibles sur cette liste
- rédaction : un artice dans la rubrique spip-zone du site
(qu'éventuellement tu administres ... )
Sachant que le zip à télécharger que proposera l'article peut être généré
automatiquement sur spip-zone et être placé en doc joint distant dans
l'article.
Le 02/06/06, Pierre Noguer<pierre.noguer@ac-grenoble.fr> a écrit :
Après les deux mails de Gilles et James, c'est un peu plus clair, mais
...la tentative d'ouverture de page que j'avais faite était dans : http://trac.rezo.net/trac/spip-zone/wiki/LesProjets
qui est la seule page accessible de la page d'accueil : Connexion · GitLab
qui parle des plugins alors que la page encore vide citée par Gilles : Connexion · GitLab
n'est pas accessible de la page d'accueil.
Je viens de la rajouter. Au passage, tu es libre de rajouter des liens
dans la page d'accueil : elle fait partie du wiki, comme toutes les
autres pages.
Au passage, j'en profite pour demander à ceux qui modifient des pages,
de mettre des commentaires pour expliquer leur modification. Cela
donne une meilleur lisibilité de l'historique d'une page.
Bref, prise de tête pour le moment
Maintenant tu peux y aller franco !
@+
.Gilles
---
Je me suis inscrit, et effectivement, ça me donne la possibilité de
créer une page, mais c'est sûr qu'il vaut mieux éviter d'en créer dans
tous les coins.
James a écrit :
> Pierre Noguer wrote:
>
>> J'aimerais participer à la doc en tant que testeur de plugins, à défaut
>> d'être capable de participer à la programmation. Je ne sais pas trop ou
>> faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini
>> de Spip Contrib ? Sur le wiki de Spip zone ?
>>
>
> C'est un peu vrai, cet aspect des choses n'est pas vraiment au point.
>
>> un exemple : il y a dans le dossier du plugin forms un fichier
>> lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
>> Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
>> compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
>> pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
>> du wiki une entrée spip-forms avec une ligne de descriptif et un lien
>> vers une page dédiée ou au moins ce texte lisezmoi devrait être
>> reproduit. Par contre, je n'ai apparemment pas la main pour créer la
>> page. Marche autrement, ce wiki ?
>>
>
> à priori on ne s'en sert pas. ce que tu as trouvé, ça doit être un résidu
> historique de l'époque où c'était développé sur le lab... enfin je crois.
>
>> Bref, j'aiderais bien, mais comment ?? et où ?
>>
>
> le mieux, c'est de faire ça en deux temps :
>
> - maïeutique : 'aider' l'auteur du plugin à expliquer le plus de choses
> possibles sur cette liste
> - rédaction : un artice dans la rubrique spip-zone du site
> (qu'éventuellement tu administres ... )
>
> Sachant que le zip à télécharger que proposera l'article peut être généré
> automatiquement sur spip-zone et être placé en doc joint distant dans
> l'article.
>
> Mais *surtout*, tu fais comme tu veux.
>
>> Pierre N
>>
>> _______________________________________________
>> spip-zone@rezo.net - http://listes.rezo.net/mailman/listinfo/spip-zone
>>
>
> --
> James
>
Selon Pierre Noguer <pierre.noguer@ac-grenoble.fr>:
un exemple : il y a dans le dossier du plugin forms un fichier
lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
du wiki une entrée spip-forms avec une ligne de descriptif et un lien
vers une page dédiée ou au moins ce texte lisezmoi devrait être
reproduit. Par contre, je n'ai apparemment pas la main pour créer la
page. Marche autrement, ce wiki ?
C'est moi qui ait rédigé ce début de fichier lisez-moi. Je pense qu'il est plus
pratique d'avoir un fichier dans le répertoire du pleuguine, car comme tu le
dis, entre les différents sites avec de la doc, on s'y perd un peu. Je n'ai pas
trop regardé dans le détail les réponses que l'on t'a faites, mais si la doc est
doublée sur le wiki et dans le dossier du pleuguine, ça reste plus pratique.
J'ai modifié l'adresse dans le fichier pour participer à la doc, mais je n'ai
pas encore regardé comment le wiki marchait. Je te laisse mettre le fichier
lisez-moi sur cette page, et participer à sa rédaction. Je vais observer et
voir comment ça tourne...
Selon Pierre Noguer <pierre.noguer@ac-grenoble.fr>:
un exemple : il y a dans le dossier du plugin forms un fichier
lisezmoi.txt signé "Arnaud Martin, Antoine Pitrou, Philippe Riviere,
Emmanuel Saint-James" qui donne un premier jet de doc et invite à le
compléter sur le wiki de spip zone. Mais sur le wiki, ce texte n'y est
pas, je ne l'ai pas trouvé en tous cas. J'ai créé sur la page d'accueil
du wiki une entrée spip-forms avec une ligne de descriptif et un lien
vers une page dédiée ou au moins ce texte lisezmoi devrait être
reproduit. Par contre, je n'ai apparemment pas la main pour créer la
page. Marche autrement, ce wiki ?
C'est moi qui ait rédigé ce début de fichier lisez-moi. Je pense qu'il est plus
pratique d'avoir un fichier dans le répertoire du pleuguine, car comme tu le
dis, entre les différents sites avec de la doc, on s'y perd un peu. Je n'ai pas
trop regardé dans le détail les réponses que l'on t'a faites, mais si la doc est
doublée sur le wiki et dans le dossier du pleuguine, ça reste plus pratique.
J'ai modifié l'adresse dans le fichier pour participer à la doc, mais je n'ai
pas encore regardé comment le wiki marchait. Je te laisse mettre le fichier
lisez-moi sur cette page, et participer à sa rédaction. Je vais observer et
voir comment ça tourne...
OK ! ceci dit, le plugin marche pas chez moi pour le moment : pas de création des champs
Selon Pierre Noguer <pierre.noguer@ac-grenoble.fr>:
OK ! ceci dit, le plugin marche pas chez moi pour le moment : pas de
création des champs
Oui, visiblement la dernière mise à jour a tout cassé. Malheureusement, je suis
comme toi, je ne suis pas développeur et j'aide à la rédaction en testant.
Faut attendre qu'une prochaine mise à jour rétablisse tout ça...
J'aimerais participer à la doc en tant que testeur de plugins, à défaut
d'être capable de participer à la programmation. Je ne sais pas trop ou
faire ça, ça a l'air un peu de partir dns tous les sens. Sur le spikini
de Spip Contrib ? Sur le wiki de Spip zone ?
J'ai fait une doc sur le Plugin de Mortimer (chercher Squelette) sous forme d'un article Spip référencé sur Spip-contrib. Il n'y a de zip associé, mais ça reste une possibilité ouverte. Je crois que la doc utilisateur peut-être n'importe où, l'essentiel étant que l'URL soit indiqué dans le XML du Plugin mais ç'est mieux de regrouper sur Spip-contrib qui après tout a été fait pour ça.
La zone sert plutôt au développement collaboratif, mais il manque une doc de développement, genre README, qui pourrait être référencé automatiquement sur le Wiki Spip zone . Ca donnerait une vision synthétique des projets (ce qu'ils sont, où ils en sont) et ça peut servir dans un premier temps de doc utilisateur.
Voilà un exemple de Shell script (sous cron) qui fabrique les <a href> des README. Je ne sais pas si ça peut s'installer un Shell cron sur la zone ?
Selon Pierre Noguer <pierre.noguer@ac-grenoble.fr>:
Non, pas vraiment. Je voudrais que quand on crèe une doc sur un plugin,
dans la page Connexion · GitLab, on
puiise écrire en haut une sorte d'index des plugins qui sont documentés
dans cette page et qu'un clic sur Spip-forms par exemple, envoie vers le
bon endroit de la page. mais si on écrit == Spip-forms == en haut, ça
renvoie pas vers == Spip-forms == qui est en début du texte.
Je ne sais pas si c'est possible de faire ça. Faudrait voir dans la doc ou poser
la question sur SPIP-zone (que je mets en copie)...
Non, pas vraiment. Je voudrais que quand on crèe une doc sur un plugin,
dans la page Connexion · GitLab, on
puiise écrire en haut une sorte d'index des plugins qui sont documentés
dans cette page et qu'un clic sur Spip-forms par exemple, envoie vers le
bon endroit de la page.
Pourquoi ne pas avoir plutôt une page par plugin, et donc sur cette page juste la liste de liens ???
Non, pas vraiment. Je voudrais que quand on crèe une doc sur un plugin,
dans la page Connexion · GitLab, on
puiise écrire en haut une sorte d'index des plugins qui sont documentés
dans cette page et qu'un clic sur Spip-forms par exemple, envoie vers le
bon endroit de la page.
Pourquoi ne pas avoir plutôt une page par plugin, et donc sur cette page juste la liste de liens ???
-Nicolas
Pourquoi pas, c'est peut-être mieux (page moins lourde), les autres en pensent quoi ?
Selon Pierre Noguer <pierre.noguer@ac-grenoble.fr>:
Nicolas Hoizey a écrit :
>>> Non, pas vraiment. Je voudrais que quand on crèe une doc sur un plugin,
>>> dans la page Connexion · GitLab, on
>>> puiise écrire en haut une sorte d'index des plugins qui sont documentés
>>> dans cette page et qu'un clic sur Spip-forms par exemple, envoie
>>> vers le
>>> bon endroit de la page.
>
> Pourquoi ne pas avoir plutôt une page par plugin, et donc sur cette
> page juste la liste de liens ???
>
>
> -Nicolas
>
Pourquoi pas, c'est peut-être mieux (page moins lourde), les autres en
pensent quoi ?
Le 02/06/06, Pierre Noguer<pierre.noguer@ac-grenoble.fr> a écrit :
Nicolas Hoizey a écrit :
>>> Non, pas vraiment. Je voudrais que quand on crèe une doc sur un plugin,
>>> dans la page Connexion · GitLab, on
>>> puiise écrire en haut une sorte d'index des plugins qui sont documentés
>>> dans cette page et qu'un clic sur Spip-forms par exemple, envoie
>>> vers le
>>> bon endroit de la page.
>
> Pourquoi ne pas avoir plutôt une page par plugin, et donc sur cette
> page juste la liste de liens ???
>
Je vote pour.
Une petite synthèse avec chaque lien ne serait pas mal..
Rappel : pour créer une page, il faut être identifié. Il suffit
ensuite de saisir l'adresse avec les 2 majuscules.
Pour s'entrainer au formatage, c'est ici :
Le fil RSS pour suivre les modifs du wiki, c'est
@+
.Gilles
---
>
> -Nicolas
>
Pourquoi pas, c'est peut-être mieux (page moins lourde), les autres en
pensent quoi ?
Oui je fais ça, le temps de vérifier que c'est bien à jour.
Quels sont vos avis pour l'hébergement de cette doc :
le Wiki Zone ou le Wiki Contrib ?
Ben je sais pas trop. Disons que tant que c'est expérimental, ça pourrait rester sur la zone et être transféré sur contrib dans un deuxième temps, non ? Au passage, il faudrait aussi un bon coup de balai/rangement sur le wiki contrib, il me semble. mais c'est un autre boulot ...
