Home > Bug reports > Explication sur les exec peu pédagogique

Bug report #161 - Explication sur les exec peu pédagogique

Created on Wednesday 30 September 2009

Assigned to:
This bug has been assigned to nobody.

La clarté est certes une notion subjective, mais la page sur les boîtes d’infos n’est, je trouve, pas très claire. Il est fait mention d’un "type d’encart" qui s’appelle boite_infos, mais ensuite on voit "il est utilisé de la sorte", suivi d’un bloc de code qui ne contient pas le texte "boite_infos".

Ensuite, on lit "cette fonction". Laquelle ? Probablement cadre_nom_infos(), mais déjà c’est pas sûr du tout, et ensuite la fonction qui apparaît dans le bloc de code suivant s’appelle cadre_champs_extras_infos().

De manière générale c’est très concis, il y a peu de texte d’explication (ou alors très dense, avec beaucoup d’informations nouvelles en peu de mots), et surtout du code. C’est certainement suffisant pour quelqu’un qui sait déjà comment ça marche, mais pour ma part, je voulais me renseigner sur comment faire une page exec pour un plugin, et en conclusion je me suis dit "bon ben j’irai voir comment le font les autres plugins".

De manière générale j’ai cette sensation sur de nombreux chapitres, même si parfois j’aurais du mal à préciser d’où ça vient... juste le besoin de relire 5 fois chaque phrase et en décortiquer chaque mot.

No comment

Bug report or comment only available for registered users.

Log in.