Re: Doc technique nouveautés SPIP 3.3

Le 06/03/2021 à 14:54, JLuc a écrit :
> 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" ?

Réflexion intéressante.

Il y a des bouts de docs à droite à gauche :

- dans le plugin dev il y a des éléments de charte du back office, html 
et css, mais ce n'est pas une doc hyper accessible pour autant.

- sur spip.net il y a aussi le markup officiel des formulaires 
(https://www.spip.net/fr_article3791.html) mais à mettre à jour par 
rapport aux dernières modifs en 3.3

Tiens, au passage, autre doc à mettre à jour (dist en html5 en 3.3) :
https://www.spip.net/fr_article5720.html#Structure-du-HTML

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é.

-- 
nicod_