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

Répondre à