Je rebondis sur le post de @Abdelazer : https://zestedesavoir.com/forums/sujet/9442/rediger-sur-zeste-cest-quand-meme-un-peu-complique/
Ceci afin de ne pas lui « hacker » le sien.
Donc oui, je voulais aussi faire mon retour d’expérience, car je vois que je ne suis pas le seul.
Je ne peux que confirmer le calvaire de la rédaction sur ZdS. C’est paradoxal. Le site et l’interface sont propres, les gens sont dévoués (je remercie encore une fois tous les bénévoles, changez pas ! <3 ), mais on capte rien du tout, c’est un fouillis sans nom. Dès que tu veux faire un truc qui te semble simple, c’est compliqué. J’ai failli abandonner plusieurs fois (j’ai fait des pauses plusieurs fois de plusieurs mois tellement c’est une souffrance).
Petite histoire
J’ai commencé la rédaction de mon tuto. Première galère, Partie/chapitre/section. Ah, mais j’ai des boutons qui s’affichent ou se masquent suivant je ne sais quoi (comment faire une demande sur le forum sur un truc qu’on comprend pas…).
Je tente zWriter, ouf, je comprends enfin un peu mieux les concepts et j’ai fait une grosse partie de mon tuto avec (~50 %), mais le mécanisme d’upload d’image est inexistant (ou bien j’ai pas compris), je ne sais pas pourquoi, je ne comprends pas ce qui se passe sous le capot, je décide de revenir a l’interface Web.
Je trouve ça pas pratique, puis, a l’époque, impossible de masquer des parties de son tuto. Je décide de laisser tomber ZdS et de convertir mon tuto pour un site statique que je mettrai en ligne, je commence a faire du Python (je suis dev Python) pour avoir un système de génération de site statique de tuto en utilisant le zMarkdown dispo sur github. C’est difficile, J’abandonne.
Je me décide à terminer mon tuto.
Mécanisme de validation imbitable (mon tuto a fini par être valide, mais j’ai aucune espèce d’idée du comment de qu’est-ce qui c’est passe sous le capot il y a des beta, du brouillon, des en validation, des publiés), mais, encore une fois, je suis très bien aide (gros merci a @Aabu !). On a l’impression de ZdS a été pensé par des validateurs, tout le mécanisme semble tourner autour de ça avec des étapes bien spécifiques qui au final, je pense complexifie un peu le truc.
Ce que je pense qu’il serait intéressant de creuser. Je mets tout en vrac.
Aucune documentation clair/accessible sur la structure d’un tutoriel
Ça c’est le pire quand tu commences. Il nous faut un tuto sur la rédaction d’un tuto. C’est quoi un chapitre, une partie, une section ? Qui peut être mis dans quoi ? Tu peux mettre des sections dans une partie mais uniquement si elle n’a pas de chapitre. J’ai fait un big tuto et je l’apprends maintenant parce que le menu est « caché si tu as déjà un chapitre dans ta partie » WTF ? Pourquoi cacher ce genre de chose ? C’est tellement important. Montrez le lien « + Ajouter une section », grisez-le et mettez une tooltip dessus « Impossible de créer une section car elle contient déjà des chapitres. Une partie ne peut être compose que de chapitres, ou de section. »
Juste ça, ça aiderait a fond !
Comment peut-on comprendre si ce genre de choses est caché ? On ne peut même pas demande de l’aide sur le forum. Car on demanderait de l’aide « pour quoi » ?
On commence à comprendre en allant voir des pages perdus sur le site, des pages comme « Guide du contributeur », « Rédiger sur ZdS », et sûrement d’autre car, vu qu’elles ne sont référencées nulle part, bah on tâtonne, on cherche, parfois on perd du temps à demander sur les forums.
Il devrait y avoir une section « Aide » dans le menu de gauche accessible depuis n’importe quel endroit du tuto qu’on rédige.
Dedans on y mettrait les pages qu’on juge nécessaire a la rédaction d’un tuto :
- « Guide du contributeur »: J’ai appris que cette page existait au milieu de la rédaction de mon tuto (après 6 mois).
- « Formatage du texte » qui pointe vers le tuto « Rédiger sur ZdS ».
- Et sûrement d’autres car, bah j’en ai pas trouvé d’autre alors que je n’aurais jamais du avoir a les chercher.
Si vous connaissez reddit, l’aide au formatage est accessible directement sous le formulaire de texte et il dispose d’un lien vers une page dédiée. C’est ce genre de chose qu’il faut avoir en tête : « Proposer l’aide a l’endroit ou l’utilisateur en aurait besoin.
Placer une image dans son tuto est un mécanisme rébarbatif.
Je sais qu’il y a des choses qui ont été faites récemment. Moi j’aimerais faire des copier-coller dans mes tutos pour pas me prendre la tête (dans un premier temps) et avoir une page contenant les images « pas utilisées » qui seront supprime dans les 15 jours.
Ça permet de s’éviter l’administration des images pendant qu’on fait sa rédaction, quitte a le faire après.
La gestion des « versions » des images n’est pas utile celons-moi.
Bah si ! On peut le faire, il suffit d’aller ici et de faire …
Et voila le fond du problème. Tu passes ton temps à chercher et à poser des questions (que tu ne devrais pas avoir a te poser) sur le forum. Questions qui sont souvent difficiles à poser car, justement, tu captes même pas comment la formuler.
L’interface doit se suffire à elle-même pour ce qui est de la rédaction de tutos. Il ne doit pas y avoir de logique cachée (pitié ne cachez pas les choses, montrez-les et expliquer pourquoi on ne peut pas agir dessus, c’est 1000x plus compréhensible).
Encore une fois, je suis vraiment en admiration devant l’implication des bénévoles (c’est sincère, le fait d’avoir vu des gens se donner du mal pour m’aider m’a aussi boosté à finir mon tuto), mais il y a un problème de fond sur la prise en mains du site par des gens qui n’ont pas envi de papoter sur le forum, pas envi de fouiller les tréfonds du site pour trouver une info, mais qui ont juste envi de rédiger un tutoriel.
Je ne souhaite blesser personne et j’écris ça uniquement dans le but de faire remonter mon « ressenti », forcement subjectif dans l’espoir que ça aide a faire avancer les choses.
