[SPIP Zone] commit de plugin

Archives Zone
1

Hello,

il m'arrive de voir passer des commit, et je me dit c'est quoi ce plugin a quoi sert il

si je clic sur le lien du commit j'arrive sur la zone spip et je peu remonter jusqu'a la source

https://zone.spip.net/trac/spip-zone/browser/spip-zone/_plugins_/le_plugin

malheureusement je trouve jamais l'info , une explication succincte , un .txt dudit plugin

contrairement a ce qu'on peu trouver sur https://github.com

exemple : https://github.com/otetard/spip_souscription

Ma question ou dois je chercher qu'est ce que je fais de mal pour pas trouver l'info ?

--
Courriel: team@spipfactory.fr
Site: https://spipfactory.fr/
IRC: https://webchat.freenode.net/?channels=%23%23spipfactory

En répondant a ce courriel vous acceptez implicitement la diffusion, l'échange de la conversation, sauf avis contraire clairement exprimé.

2

Hello :blush:
Alors en réalité, c'est très simple, il te suffit de regarder le fichier paquet.xml ou plugin.xml (s'il n'y a pas de paquet.xml) et normalement, tu verras dedans un lien vers la doc si l'auteur n'a pas fait d'oubli.
Exemple :
https://zone.spip.net/trac/spip-zone/browser/spip-zone/_plugins_/mediaspip_player/trunk/paquet.xml#L9
Comme tu peux le voir dans l'exemple, il est même possible également d'avoir encore plus d'info (démonstration, développement) même si rare sont les plugs sur la zone à avoir autre chose qu'un lien de doc.
Les docs sont normalement sur contrib, mais l'auteur est parfaitement libre de la mettre ailleurs, le problème quand il fait ça, est que si une personne souhaite faire des modifications à un plug, la doc ne va pas forcément suivre :frowning:
Franck

-----Message d'origine-----
De : teamspipfactory@gmail.com <teamspipfactory@gmail.com>
Envoyé : samedi 20 octobre 2018 08:27
À : spip-zone@rezo.net
Objet : [SPIP Zone] commit de plugin

Hello,

il m'arrive de voir passer des commit, et je me dit c'est quoi ce plugin a quoi sert il

si je clic sur le lien du commit j'arrive sur la zone spip et je peu remonter jusqu'a la source

https://zone.spip.net/trac/spip-zone/browser/spip-zone/_plugins_/le_pl
ugin

malheureusement je trouve jamais l'info , une explication succincte , un .txt dudit plugin

contrairement a ce qu'on peu trouver sur https://github.com

exemple : https://github.com/otetard/spip_souscription

Ma question ou dois je chercher qu'est ce que je fais de mal pour pas
trouver l'info ?

--
Courriel: team@spipfactory.fr
Site: https://spipfactory.fr/
IRC: https://webchat.freenode.net/?channels=%23%23spipfactory

En répondant a ce courriel vous acceptez implicitement la diffusion, l'échange de la conversation, sauf avis contraire clairement exprimé.

----
spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

3

Bonjour

La notification par mail renvoi sur le commit concerné et non la racine du projet, les 2 liens ne sont pas comparables.

Pour faire une équivalence il faudrait un lien du genre

https://github.com/otetard/spip_souscription/commits/master

Je vais regarder si on peut afficher sur la zone à la racine des plugins, les fichiers readme ou paquet.xml, c’est une évolution intéressante.

Merci

Km

Le sam. 20 oct. 2018 à 09:19, Franck <spip.franck@lien-d-amis.net> a écrit :

Hello :blush:
Alors en réalité, c’est très simple, il te suffit de regarder le fichier paquet.xml ou plugin.xml (s’il n’y a pas de paquet.xml) et normalement, tu verras dedans un lien vers la doc si l’auteur n’a pas fait d’oubli.
Exemple :
https://zone.spip.net/trac/spip-zone/browser/spip-zone/plugins/mediaspip_player/trunk/paquet.xml#L9
Comme tu peux le voir dans l’exemple, il est même possible également d’avoir encore plus d’info (démonstration, développement) même si rare sont les plugs sur la zone à avoir autre chose qu’un lien de doc.
Les docs sont normalement sur contrib, mais l’auteur est parfaitement libre de la mettre ailleurs, le problème quand il fait ça, est que si une personne souhaite faire des modifications à un plug, la doc ne va pas forcément suivre :frowning:
Franck

-----Message d’origine-----
De : teamspipfactory@gmail.com <teamspipfactory@gmail.com>
Envoyé : samedi 20 octobre 2018 08:27
À : spip-zone@rezo.net
Objet : [SPIP Zone] commit de plugin

Hello,

il m’arrive de voir passer des commit, et je me dit c’est quoi ce plugin a quoi sert il

si je clic sur le lien du commit j’arrive sur la zone spip et je peu remonter jusqu’a la source

https://zone.spip.net/trac/spip-zone/browser/spip-zone/plugins/le_pl
ugin

malheureusement je trouve jamais l’info , une explication succincte , un .txt dudit plugin

contrairement a ce qu’on peu trouver sur https://github.com

exemple : https://github.com/otetard/spip_souscription

Ma question ou dois je chercher qu’est ce que je fais de mal pour pas
trouver l’info ?

–
Courriel: team@spipfactory.fr
Site: https://spipfactory.fr/
IRC: https://webchat.freenode.net/?channels=%23%23spipfactory

En répondant a ce courriel vous acceptez implicitement la diffusion, l’échange de la conversation, sauf avis contraire clairement exprimé.

spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

spip-zone@rezo.net - https://listes.rezo.net/mailman/listinfo/spip-zone

4

merci pour l’info

je retiens :

si l'auteur n'a pas fait d'oubli.

dans ce cas la vu que je ballade pas mal , est ce qu’il y a un endroit pour signaler l’oublie ou faut il contacter directement l’auteur

je prend un exemple au hasard

je remonte

et je vais dans /trunk

je visionne pas

un lien vers la doc

pourtant :

et l’exemple donné

5

Je ne comprend rien à cette validation de paquet.
C’est quoi le rapport avec le lien de doc.
En plus, si tu parles du paquet de continents il valide sans problème.
Donc c’est quoi le souci si il y en a ?

6

Le 20/10/2018 à 11:23, teamspipfactory@gmail.com a écrit :

https://zone.spip.net/trac/spip-zone/browser/spip-zone/_plugins_/continents/trunk/paquet.xml

je visionne pas un lien vers la doc
pourtant https://plugins.spip.net/redaction-du-paquet-xml.html je peu lire

> il est fortement recommandé de remplir précisément ces informations :

mais il est donc possible pour chaque auteur de déposer des plugins sur la zone qui sont en dehors de la nomenklatura ?

Pas certain de comprendre, mais "fortement recommandé" ne veut pas dire "obligatoire".

JL

7

yo

pour faire simple :wink:

effectivement je n’ai rien compris et il y a aucun soucis .

et aucun rapport avec le lien doc

8

Le 20/10/2018 à 18:04, JLuc a écrit :

Le 20/10/2018 à 11:23, teamspipfactory@gmail.com a écrit :

https://zone.spip.net/trac/spip-zone/browser/spip-zone/_plugins_/continents/trunk/paquet.xml

je visionne pas un lien vers la doc
pourtant https://plugins.spip.net/redaction-du-paquet-xml.html je peu lire

> il est fortement recommandé de remplir précisément ces informations :

mais il est donc possible pour chaque auteur de déposer des plugins sur la zone qui sont en dehors de la nomenklatura ?

Pas certain de comprendre, mais "fortement recommandé" ne veut pas dire "obligatoire".

JL

tout a fait

donc on revient au départ qu'on peu pas avoir l'info via le commit

--
Courriel: team@spipfactory.fr
Site: https://spipfactory.fr/
IRC: https://webchat.freenode.net/?channels=%23%23spipfactory

En répondant a ce courriel vous acceptez implicitement la diffusion, l'échange de la conversation, sauf avis contraire clairement exprimé.

9

Le 20/10/2018 à 23:29, teamspipfactory@gmail.com a écrit :

donc on revient au départ qu'on peu pas avoir l'info via le commit

Ben si, on *peut*, mais ce n'est pas obligatoire, c'est aux gens qui
commitent de bien remplir le message de log, c'est tout, et on le dit et
redit régulièrement.

Car qu'il y ait un readme ou lien vers une doc etc, ça ne change rien
qu'il y a plein de gens qui suivent la liste des commits, et qu'on n'a
pas à demander aux gens de devoir cliquer un par un sur chaque plugin
pour aller voir les détails. On devrait toujours avoir les infos de base
dans les logs de commits.

--
RastaPopoulos

10

Le 21/10/2018 à 10:07, RastaPopoulos a écrit :

Le 20/10/2018 à 23:29, teamspipfactory@gmail.com a écrit :

donc on revient au départ qu'on peu pas avoir l'info via le commit

Ben si, on *peut*, mais ce n'est pas obligatoire, c'est aux gens qui
commitent de bien remplir le message de log, c'est tout, et on le dit et
redit régulièrement.

Car qu'il y ait un readme ou lien vers une doc etc, ça ne change rien
qu'il y a plein de gens qui suivent la liste des commits, et qu'on n'a
pas à demander aux gens de devoir cliquer un par un sur chaque plugin
pour aller voir les détails. On devrait toujours avoir les infos de base
dans les logs de commits.

ok, mais en général ça c'est plutôt réalisé donc c'est cool
le sujet de départ été plutot quand il y a un commit sur un plugin
ou avoir les explication du plugin

je pense que je vais stopper le sujet mais plutôt donné des exemples ça sera plus parlant :wink:

à+ et dsl de déranger par des suggestions ou des questionnement basic pour certain :wink:

--
Courriel: team@spipfactory.fr
Site: https://spipfactory.fr/
IRC: https://webchat.freenode.net/?channels=%23%23spipfactory

En répondant a ce courriel vous acceptez implicitement la diffusion, l'échange de la conversation, sauf avis contraire clairement exprimé.

11

Les explications sur un plugin sont sur Plugins SPIP qui présente la paquet.xml d’une façon compréhensible.
On y retrouve le nom, le slogan et la description si cela a été saisi.
Et puis on voit aussi le lien vers la documentation où qu’elle soit (souvent sur Contrib).

Donc le bon endroit pour faire une recherche c’est Plugins SPIP.

12

Le 21/10/2018 à 11:49, Eric Lupinacci a écrit :

Les explications sur un plugin sont sur Plugins SPIP qui présente la paquet.xml d'une façon compréhensible.
On y retrouve le nom, le slogan et la description si cela a été saisi.
Et puis on voit aussi le lien vers la documentation où qu'elle soit (souvent sur Contrib).

Donc le bon endroit pour faire une recherche c'est Plugins SPIP.

Quand il a été ajouté à l'archivelist :slight_smile:

--
nicod_