[spip-dev] Quand sera-t-il raisonnable d'utiliser Spip 3 en production?

Et avant cela, d'être cohérent et constant dans ses dénominations, dans SPIP lui-même (dans le code, les arbos, l'interface, etc.) !

Un seul exemple : comment deviner que ce qui s'appelle « plugin verrouillé » dans l'interface est la même chose ce qui est rangé non pas dans le répertoire « plugins » mais dans celui appelé « extensions », dans SPIP, mais dans un répertoire appelé « plugins » sur la zone et distribué comme « plugin » sur le site officiel plugins.spip.net, etc. ? C'est un jeu de mots pour voir ceusses qui arrivent à suivre ? Et qui parviendra à rédiger une phrase de doc compréhensible à partir de choses aux noms aussi variables ?

En l'état, ce n'est pas prêt à être distribué, ni même documenté :smiley:

Sauf en Papouasie, où il y a des Papous papas et des Papous pas papas. Il y a des poux chez les Papous, et il y a donc des Papous papas à poux, des Papous papas pas à poux, des Papous pas papas à poux et des papous pas papas pas à poux. Mais parmi les poux, il y a les poux papas et les poux pas papas. Il y a donc des Papous papas à poux papas, des Papous papas à poux pas papas, des Papous papas pas à poux, des Papous pas papas à poux papas, des Papous pas papas à poux pas papas et des Papous pas papas pas à poux...

-- Romy

Pour ma part, j'ai relié ces deux sources en réfléchissant à une
refonte qui permette une campagne collaborative d'écriture de la
documentation et j'en suis pour le moment arrivé à ceci
:http://www.spip-contrib.net/ Proposition-de-refonte-de-spip-net

Dommage de refaire un deuxième article sur le même sujet + avec le même
titre quasiment, au lieu d'essayer d'avancer à partir d'une même base.
Je rappelle que le but n'est pas de repartir à zéro, ça me parait
difficilement faisable, surtout qu'il n'y a pas qu'une langue à
reprendre mais il faut prendre en compte les dizaines de langues déjà
existantes et le fait qu'il n'y a pas le même contenu dans chaque.
Bref : faire avec l'existant avant tout.
Ma proposition cherchais donc à tout réorganiser, certes, mais en se
basant sur les articles existants afin d'avoir à faire le plus possible
des déplacements, plutôt que des créations ex-nihilo.

Sauf que, dis moi si je me trompe, en attaquant le problème avec juste
une réorganisation de la doc : c'est compliqué...

En lisant et relisant les fils de discussion, je me suis demandé si on
attaquait pas la montagne par un voie trop escarpée...

Car, en fait, il y a bien deux principes qui semblent a priori
inconciliables dans ces échanges :
- faire avec l'existant
- et repartir sur de nouvelles bases.

En somme : on ne veut pas partir d'une page blanche, mais en même temps,
on aimerait bien tourner la page !

Et chaque version majeure de spip relance le débat...

J'en suis venu à me dire qu'il ne fallait pas un chantier (ponctuel) de
refonte de la doc mais une démarche permanente de refonte de la doc...

D'où l'idée que chaque nouvelle version majeure enclenche un archivage de
la doc et la mise en place d'une nouvelle version, même si on reprend
tout ou partie des textes existants. Cela existe ailleurs, par exemple,
un bouquin de doc sur ubuntu ressort remanié à chaque version. Mais le
hic, c'est que c'est le travail d'un auteur principal. Or il faudrait
avoir une méthodologie qui permette à tout spipeur d'apporter une
contribution. C'est une demande récurrente aussi : avoir le moyen de
pouvoir faire un retour à la communauté même tout petit petit...

Ce problème de l'*edition participative* ou *collaborative*
me semble /culturellement/ difficile dans le monde SPIP ;
pet-etre cela est-il dû au modèle auteur-redacteur unique
qui est induit par la gestion de l'espace privé de SPIP

D'où l'idée de structurer le plus possible : une ligne éditoriale
générale, une ligne éditoriale par rubrique, et une seule question
traitée par article.

Cette idée reste à être éprouvée en la confrontant à la réalité (d'où ma
page à part sur le carnet...) mais si ça se tient, on aura un listing des
questions à traiter établi par les admin de spip.net (qui pourra faire
l'objet de suggestion de tout spipeur) et chaque question pourra être
traitée par qui veut s'y coller en respectant une ligne éditoriale et des
consignes pour que cela ne parte pas en vrille.

Les articles qui n'évoluent pas entre deux versions, sont simplement
repris. La différence avec la situation d'aujourd'hui est qu'ils
recevront une revalidation explicite (nouvelle date) ce qui est une
indication claire pour le nouvel utilisateur qui s'intéresse uniquement à
la version de spip qu'il vient de télécharger ; et que l'opération donne
la possibilité de remanier un texte sans changer le fond mais simplement
pour qu'il soit plus clair ou ajouter un lien ou un exemple...

Il me semble que commencent à sortir des plugins de "duplication d'articles" ou d'ajouts automatisés qui vont dans cette voie.

Mais pour les articles de fond, je me demande à l'inverse,
si une autre voie n'est pas à privilégier ; en effet,
les articles actuels (sur Spip.net du moins) concentrent
la totalité de l'information toutes versions confondues.
    Si une comprehension totale en est parfois moins immédiate,
Cela presente l'avantage de toujours donner les informations d'evolution
ce qui peut aider (et inciter) les nouveaux (en particulier ceux qui reprennent un vieux site -et ils sont nombreux-) à continuer
a faire evoluer les sites en SPIP, etant déjà familiarisés....

Mais bon, tout ceci n'a rien à faire dans ce fil de discussion. :slight_smile:

Faut voir. SPIP 3 a besoin de sa doc pour sortir... L'idée qui a été
lancée d'organiser une campagne d'écriture de la doc serait peut être un
projet stimulant pour les spipeurs et un buzz intéressant pour l'arrivée
de la version... même pour les articles en langues étrangères qui parfois
datent aussi...

L'autre voie possible est d'insérer des niveaux de lecture,
qui permettraient conditionnellement de masquer certains paragraphes,
quand le lecteur veut spécifiquement s'intéresser à une version typée !
- soit avoir un test filtrant de paragraphes par version,
- soit proposer des modèles de bribes d'articles, qui permettraient de recomposer l'article en une présentation adaptée....

Mes 2 sous d'idé&es du jour
YannX

....

D'où l'idée que chaque nouvelle version majeure enclenche un archivage de
la doc et la mise en place d'une nouvelle version, même si on reprend
tout ou partie des textes existants. Cela existe ailleurs, par exemple,
un bouquin de doc sur ubuntu ressort remanié à chaque version. Mais le
hic, c'est que c'est le travail d'un auteur principal. Or il faudrait
avoir une méthodologie qui permette à tout spipeur d'apporter une
contribution. C'est une demande récurrente aussi : avoir le moyen de
pouvoir faire un retour à la communauté même tout petit petit...

Ce problème de l'*edition participative* ou *collaborative*
me semble /culturellement/ difficile dans le monde SPIP

Pour moi le problème est d'abord la mauvaise habitude de ne pas documenter son code.
J'ai fait dans le forum de cet article:

une proposition pour l'aide en ligne mais qui est applicable à la doc en général,
savoir que la gestion de l'évolution de la documentation doit être déléguée
à un outil fait pour ça, savoir Subversion.
Il faudrait choisir dans spipnet les articles de doc encore valables,
les importer massivement sur le serveur Subversion et truffer les pages privées de SPIP
de lien vers ces articles (à la fois dans le code HTML produit et dans commentaires PHP).
Ainsi la doc serait plus facilement accessible, et les programmeurs auraient peut-être l'idée
de la changer quand ils changent le code qu'elle décrit.
Faute de faire ça, SPIP3 et ses plugins ne seront jamais utilisés que par leurs développeurs.
Mais c'est peut-être le désir plus ou moins conscient de qui développe pendant 2 ans sans documenter.

Committo,Ergo:Sum

Pourquoi dans ce cas ne pas dire qu’une « distribution », c’est un plugin, qui liste en dépendance les autres plugins dont il a besoin, et qui contient les squelettes exploitant le core et ces plugins ?

Comme ça, plus aucun « dist » dans le core, c’est la distributon « par défaut » ou « historique » qui contient tout ça.

Cela permettra de faire des distributions minimalistes, sans brèves par exemple…

  • pourquoi le skel breve.html n’est pas dans l’extension « brèves » mais dans extensions/dist/ (cf. ticket 2502) ?
  • pourquoi le skel auteur.html est dans extensions/dist/ mais le modèle lesauteurs.html dans /squelettes-dist/modeles/lesauteurs.html ?
  • pourquoi ne pas conserver un minimum fonctionnel (article.html, rubrique.html et sommaire.html) dans /squelettes-dist ?

Hum… Idée comme ça en passant.
Pourquoi ne pas nommer le dossier squelettes-dist en « public » ?
Explication : le contenu de ce répertoire actuellement fait parti du core et n’est pas intégrable à l’extension « dist ». Mais ce n’est pas du domaine du « privé » (avec le répertoire associé dans cette version de SPIP).
Il semble donc que c’est utilisé en zone public à minima…

j'interviens en tant qu'utilisateur occasionnel (depuis 8 ans quand même), parce qu'en effet je commence à m'y perdre

SPIP c'est un noyau, des extensions distribuées avec ce noyau et des extensions additionnelles

de ce point de vue, pour reprendre la proposition et les sources de http://core.spip.org/issues/2501, il pourrait y avoir deux grands répertoires distincts :

extensions-dist comprenant
/squelettes
/prive
/plugins

extensions-add (ou extensions tout court*) optionnel comprenant
/squelettes
/prive
/plugins
/perso

dénominations qu'on retrouverait dans l'interface en « extensions distribuées » (verrouillées) et « extensions additionnelles »

ça me parait reprendre raisonnablement l'usage établi tout en clarifiant l'organisation logicielle pour l'utilisateur

il reste l'ambiguïté du terme de « plugin », puisqu'un plugin peut être par exemple un jeu complet de squelettes -- dans ce cas, cette extension pourrait être chargée dans /squelettes plutôt que dans /plugins, le répertoire /perso permettant par ailleurs les surcharges diverses

en tout cas, le terme d'extension me semble préférable à celui de plugin s'il faut en choisir un pour désigner « tout ce qu'on ajoute à SPIP » -- et pas seulement par francophonie

fred

* plus simple mais trompeur à cause du sens actuel de ce terme dans SPIP...

Tout à fait ...
Il serait vraiment bon de renommer tous ces dossiers pour avoir des noms au
maximum intuitifs.

J'invite vivement les dévellopeurs, à montrer SPIP3 à leur maman.
Puis sans lui donner aucun indice, à lui poser des questions sur le rôle qu'elle
pense que joues chaque dossier. ^^;

Je suis sûr que l'avis de personnes ne comprenant rien à un ordinateur, peux
être instructif.

Après evidement tout n'as pas besoin d'être accessible, mais il est clair que
les squelettes ou les formulaire tous le monde risque de devoir y aller faire un
tour un jour.
Et dans l'absolu, on devrait pouvoir les trouver aisément, simplement par
logique et déduction, sans avoir besoin de consulter la documentation.