Gus ashaszin a écrit :
Merci Mathieu et Rastapopoulos, ce sujet m'interpelle (ferais-je partie de la DGSE sans le savoir ? ^^ ).
mes_options.php. Un genre de "guide du programmeur spip débutant" croisé avec "les bonnes pratiques du dev spip".
Oui, débutant ou non d'ailleurs...
Pour dire quelques fonds de ma pensée...
Je suis à un point où je ne sais tellement plus où mettre la documentation que je préfère faire des billets sur mon site.
* SPIP.net se veut (si je comprends bien) pour les utilisateurs et pour les intégrateurs. Il remplit à mon sens bien ce rôle.
* Contrib reçoit les documentations des contributions, et remplit très bien ce rôle.
* Doc.spip documente les *fonctions php* de SPIP et rempli très bien ce rôle (encore que le script est cassé depuis quelques temps)
Il reste la documentation technique sur le fonctionnement, l'extension, la vision globale de SPIP qui me semble très ambigue. On en trouve des bouts sur spip.net, contrib, le carnet, doc.spip et divers trucs sur certains blogs.
C'est sur ce point précis que je m'intéresse, au point que je me dis qu'un autre site serait peut être intéressant. Je m'explique avant de recevoir les foules braquées...
Je préfère qu'on identifie un site à une seule chose claire et précise, même s'il y a beaucoup de sites, chaque site de la galaxie rempli un rôle assez clair.
Il n'y a pour ma part que doc.spip qui me gène... à moitié. Je pensais qu'il se cantonnerait à expliciter les fonctions de SPIP, son code, et simplement cela. Il tend à recevoir aussi en ce moment des compléments de documentations, c'est tout à son honneur, mais je ne suis pas certain que ça soit le bon lieu.
Pour ma part, j'imaginerais bien un nouveau site (ou un espace identifié sur doc.spip) pour reçevoir de la documentation technique sur le fonctionnement de SPIP, son arborescence, le développement de squelettes et de plugins, comment l'étendre, documenter les fonctions importantes, donner des exemples. Et j'imaginerais bien, même, un site fait un peu comme un livre, que l'on feuillette en tournant les pages... Avoir donc une bonne structure, table des matières pour que l'on puisse apprendre SPIP en lisant ce livre, qui serait comme une courbe d'apprentissage. Dans ma grande imagination, tous les contenus fournis seraient en licence cc-by-sa permettant la création automatique d'un pdf redistribuable (on peut rêver hein ?!)... Enfin, je n'imaginais pas quelque chose d'exhaustif, mais plutot quelque chose de complet, faisant le tour d'un état de SPIP à un moment donné (2.0).
Par exemple, plutôt s'attarder à décrire ce qu'est un pipeline, comment ils fonctionnent, montrer comment en utiliser certains, comment en créer de nouveaux, mais pas forcément décrire exhaustivement (avec leurs paramètres je veux dire) et précisément tous les pipes existants dans SPIP , ce qui pourrait devenir rasoir...
Le plus dur dans cette histoire, c'est de trouver une table des matières correcte et assez précise. La remplir ne sera pas le plus difficile.
