En matière de documentation, nous n’avons pas eu de succès, admet Canonical. Le distributeur Ubuntu veut désormais s’attaquer précisément à ce domaine avec un projet à long terme. L’objectif est que la nouvelle documentation comprenne les besoins de l’utilisateur, les respecte, y réfléchisse et les serve. Le fournisseur ne lésine pas non plus sur les mots en interne : ces modifications doivent changer tous les collaborateurs et leur travail.
Sommaire
Quatre pour la documentation
Concrètement, Canonical construit ce projet sur quatre piliers : Direction, Care, Execution, Equipment – ou, en gros, direction, soin, mise en œuvre et outils. Dans le premier cas, le framework Diátaxis est désormais utilisé pour la documentation. Pour le reste, ce domaine reste vague, il ne peut y avoir d’objectif défini, mais nous sommes sur la bonne voie.
Sous Care, Canonical décrit que la documentation ne peut pas être confiée à quelques personnes engagées. Elle doit au contraire être ancrée comme une discipline à part entière chez tous les collaborateurs. Un tel changement de culture est toutefois difficile à réaliser, mais l’annonce ne précise pas comment.
La meilleure documentation en parallèle
Execution décrit la volonté de Canonical d’aborder le projet par petites étapes simples et pas trop fatigantes – la documentation est un métier qui s’apprend, mais qui est trop souvent négligé. En raison de modèles erronés, on travaillerait dur pour obtenir des résultats insatisfaisants. Au lieu de cela, la documentation devrait s’intégrer dans le quotidien des collaborateurs, qui pourraient ainsi obtenir des résultats remarquables sans faire de vagues.
Enfin, le logiciel utilisé pour la documentation fait partie de l’équipement lui-même. Au lieu de s’en remettre à une décision pour le meilleur et pour le pire, Canonical veut trouver des outils adéquats par une méthode d’essai et d’erreur. Il faut toujours garder à l’esprit que la technique évolue constamment et que les outils préférés peuvent changer plus tard.
L’annonce n’est pas plus concrète sur ces quatre points. Canonical espère toutefois que non seulement les utilisateurs et les clients, mais aussi l’ensemble du monde informatique donneront leur avis sur le développement futur. L’espoir : s’ils font les choses correctement, ils seront entendus.