Re: Tuto "Créer des champs extras depuis un plugin perso avec l’aide de Saisies"

Le 05/05/2020 à 12:52, JLuc a écrit :
> Un référentiel complet ne remplace pas un tutoriel

Tu persistes à parler de choses dont personne ne parle. Depuis le début : le morceau pointé CE SONT des tutoriels ! Tu n'arrêtes pas d'argumenter comme s'il s'agissait de refuser un tutoriel parce qu'il y aurait un référentiel, alors que personne n'a parlé de ça et qu'il n'y a aucun rapport avec ça. On parle de tutoriels déjà en place, et d'un ajout de tutoriel supplémentaire, ce qui ferait QUATRE tutos pour dire la même chose. Et donc depuis le début je dis que si les tutos déjà en place ne sont pas corrects, il faut les corriger, améliorer, compléter, ou à l'inverse : simplifier. Ce que jeanmarie a bien compris et donc il est parti pour combiner et avoir tout ce qui est nécessaire en une fois (du genre un exemple simple + un exemple complexe = 2 et ça suffit). Bref depuis le début tu parles de chose qui ne correspondent pas à ce dont on parle en face…

La documentation, contrairement à ce que tu disais plutôt, demande encore plus de relecture que le code. Le code chez nous ya max 3-4 personnes qui vont le voir alors si parfois il est un peu bordélique, c'est un peu embêtant oui mais on s'en sort. Mais si la documentation a 15 articles pour dire la même chose, là ça touche beaucoup plus de monde. Tout comme le code, il ne s'agit pas du tout d'un truc publié qui ne bouge plus ensuite, on peut l'améliorer en permanence. Ce qui est le cas ici. Il est bien plus utile d'avoir 2 tutos bien faits (un simple, un complexe) en un endroit précis, que d'avoir 15 tutos qui disent "un peu pareil mais pas tout à fait", et du coup de pas savoir quoi suivre (ce qui était justement un des problèmes de la doc actuelle).

-- 
RastaPopoulos

_______________________________________________
liste: https://listes.rezo.net/mailman/listinfo/spip-dev
doc: https://www.spip.net/
dev: https://core.spip.net/
irc://irc.freenode.net/spip