Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Déception

Préambule

Avant d’aller plus loin, je tiens à rappeler que la critique n’oublie pas les services apportés et les nombreuses qualités du produit au sujet duquel elle s’exerce.

Par ailleurs, ma critique est déjà une marque d’intérêt et de soutien : il y a bien des choses dont je ne prendrais pas la peine de parler, et d’ailleurs plus la peine de m’y intéresser sauf sous la contrainte ou pour aider les simples gens qui s’en servent ou doivent s’en servir et ne savent pas, les pauvres, qu’il y a mieux ailleurs ou qu’il vaut mieux éviter de le faire.

Circonspect

Cela fait maintenant pas mal d’années que je suis le bébé mdBook, et je dois dire que je suis assez circonspect quant à ses capacités à appliquer des principes pourtant essentiels à mes yeux d’amélioration continue.

Pourtant, le dépôt officiel nous livre une belle promesse :

« mdBook is a utility to create modern online books from Markdown files. »
soit en français dans le texte :
« mdBook est un utilitaire permettant de créer des livres en ligne modernes à partir de fichiers Markdown. »

Alors, les enfants, il va falloir qu’on discute !
Vous et moi ne devons pas avoir la même notion de ce qui est moderne, je pense.

Ce qui est moderne, selon moi, dans le web et ailleurs :

  • est multilingue avec une véritable localisation de l’ensemble de ses composantes publiques (visibles des utilisateurs·trices) du site web ;
  • n’est PAS psychorigide et propose le LIBRE choix aux concepteurs des sites web quant à la manière dont leur création se comporte ;
  • évolue et s’améliore rapidement dans le temps.
    S’il est acceptable qu’un produit moderne ne fournisse pas tout dès sa sortie, tout du moins, le produit moderne vit un cycle d’amélioration continue, de préférence rapide.

Stratégie de gestion

Nous avons plusieurs possibilités pour réagir face à cela, dont voici quelques-unes seulement :

  • éviter le produit et passer à autre chose ;
  • au contraire, pour différentes raisons, préférer ce produit, et faire avec tel qu’il est ;
  • signaler les bogues et proposer des améliorations dans les tickets (issues) du gestionnaire de dépôt ;
  • regarder si le produit dispose de mécanismes licites, prévus dans sa conception, pour l’améliorer et l’ajuster à nos besoins ;
  • faire de même coûte que coûte, quitte à sortir des sentiers battus ;
  • prendre son courage à deux mains et participer au développement du produit pour pouvoir, qui sait, finir par convaincre les autres développeurs·ses et / ou proposer nous-même les correctifs qui, peut-être, seront finalement acceptés et intégrés dans le produit.

Un projet singulier

J’ai longtemps choisi une attitude personnelle composée d’un mélange d’ermitage silencieux et de la première option : ignorer et laisser tomber le produit et tracer ma route ailleurs.

J’ai finalement choisi de changer de posture après plusieurs sessions d’auto-apprentissage ou d’auto-perfectionnement en langageS de développement, de veille et de projets personnels : dorénavant, je vais m’investir plus lourdement sur le langage Rust et, par voie de conséquence, mdBook qui fait partie de son écosystème de premier rang.

L’un et l’autre sont intéressants et apportent des choses très utiles.
L’un et l’autre sont perfectibles.
L’histoire n’est pas construite à l’avance.
Chacun·e d’entre nous peut apporter sa pierre, à sa façon, avec sa personnalité, ses valeurs…

J’ai choisi de prendre le temps de rédiger et de publier des supports, qui, je l’espère, aideront d’autres que moi à mieux comprendre, apprendre et maîtriser Rust et mdBook.

J’y passe quelques messages…
Qui sait s’ils seront entendus…

Si vous souhaitez apporter votre contribution à ce livre, n’hésitez pas : contactez-moi ! (via mon site)

Marc JESTIN
éco-citoyen du monde
https://marcjestin.fr

Vous pouvez soutenir mon travail par un don libre.

Mes coordonnées bancaires