Les modèles sont déjà décrits avec du YAML quand on veut qu'ils soient
utilisables avec Insérer modèles qui génère des formulaires d'aide à
l'insertion. Donc je vois moyen l'intérêt de documenter deux fois les
mêmes choses.

Si tout était en PHPDoc (alors qu'en plus c'est pas du PHP mais des
squelettes mais ok soit un simili PHPDoc), il faudrait AUSSI une
librairie supplémentaire pour parser le PHPDoc et ainsi pouvoir générer
de la documentation automatique in situ au bon endroit pour les rédacteurs.

Donc vu que dans les deux cas faut une lib + que ya déjà un début de
description et d'utilisation avec YAML pour un certain nombre de modèles
existants, autant continuer dans la même voie.

Par contre ya aucune obligation, et ça n'a pas de rapport avec le core
pour l'instant (à moins d'intégrer une aide rédacteur bien faite pour
les modèles mais c'est loin d'être le cas pour l'instant). Donc bah si
Ybbet t'as besoin des YAML tu installes Insérer Modèles et tu complètes
les plugins que t'aimes qui te fournissent des modèles pour leur ajouter
le YAML descriptif… Un truc comme ça.

-- 
RastaPopoulos

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

Répondre à