J'ai commencé à documenter sur https://programmer.spip.net certaines nouveautés techniques de SPIP 3.3 telles que je les ai repéré dans les commits, en partant des plus récents : http://spip.pastebin.fr/85756
Des relecteurs trouveront les modifs en suivant les créations récentes dans l'accueil de l'admin ou avec les forums internes que j'ai laissé comme des cailloux blancs sur mes pas.
Je me rend compte que j'ai pas bien documenté le backport vers spip 3.2 ou 3.1 lorsque ç'a été fait en prime.
J'ai dressé une liste des features ou évolution restant à documenter pour SPIP 3.3 en partant également des commits les plus récents, depuis décembre en fait : http://spip.pastebin.fr/85755
À poursuivre donc.
Par exemple les boucles anonymes et les <BBx> ça va nécessairement sur spip.net
puisque c'est de l'écriture en SPIP.
Là je me suis occupé de ce qui convient bien à programmer.spip.net
une doc technique très proche des commits
(d'ailleurs pourrait on ajouter dans ces docs un lien vers les commits clés ?)
Pour moi, c'est plus simple d'y écrire que sur spip.net
dont je redoute le process administratif de validation, édition et correction
autant des "aspects techniques" que "rédaction en bon français".
Quelle est l'adresse du pad ?
À quoi est il destiné ?
Il n'y a pas de "liste des nouveautés SPIP 3.3" sur programmer.spip.net
Les listes que j'ai communiqué peuvent aider à faire un release log
et à créer de nouvelles docs sur spip.net ou programmer.spip.net
mais ne sont certainement pas un release log
(donc si le pad c'est un release log il doublonne pas)
Mon avis, il faut aussi un article dédié sur spip.net qui recense toutes les nouveautés sur spip.net (gestion des logos, fin du portfolio, support SVG, boucles anonymes, toussa toussa), parce que c'est une version majeure.
Je m'aperçois que la doc exhaustive (des filtres ou des constantes par exemples) est sur spip.net
donc je documente aussi sur spip.net lorsqu'il n'y a rien d'associé à un sujet sur programmer.spip.net
Vu que ces articles sont validés
je comprend qu'on attend pas la release de SPIP 3.3 pour compléter la doc de spip.net
(en précisant quand c'est "à partir de SPIP 3.3")
par exemple pour les nouveaux arguments de balise_img etc
Il y a sur spip.net des rubriques pour documenter les différents éléments utiles
mais il n'y a pas de rubrique consacrée spécifiquement aux classes css
et il n'y a pas non plus de groupe-mot qui leur soit consacré,
comme il y a pour les autres éléments afin d'en référencer l'usage hors page spécialisée.
Or les classes, outre des conséquences sur l'apparence,
ont aussi, pour un certain nombre d'entre elles, des conséquences fonctionnelles.
La nomenclature des classes est ainsi aussi une forme d'API.
Alors serait il pas souhaitable d'avoir aussi une documentation des classes et de leurs effets
visant l'exhaustivité comme les autres docs ou comme les docs des "autres" "framework css" ?
Je ne sais pas s'il y a moyen ni si c'est pertinent de rassembler tout ça quelque part, en tout cas ça ne peut pas être qu'une doc des classes CSS, le HTML est forcément lié.
Mise à jour : Pour info l'actu des todo/done de la doc :
TODO : http://spip.pastebin.fr/88139
Il reste surtout des trucs un peu pointus
ou qui ne sont pas traditionnellement documentés sur spip (doc css par exemples)
mais pas totalement que ça non plus.
DONE : http://spip.pastebin.fr/88140
Ce sont soit des créations d'articles soit des ajouts dans des articles existant
sur spip.net et programmer.spip.net
Sur spip.net, les créations d'articles sont rédigées mais ne seront publiées
que lors de la publication de spip 3.3