9 liens privés
Un vent de renouveau souffle sur l'Église du Valveruz. Cette petite fédération de six paroisses réformées se prépare à prendre un grand virage technologique. Nous étions présents à la conférence de lancement dans le temple de Col-en-Viran.
[Toute] institution vit dans une sorte de contradiction: elle existe pour tirer profit de l'effort du groupe, mais une partie de ses ressources sont dépensées pour diriger cet effort. Appelons cela le dilemme institutionnel, parce qu'une institution dépense des ressources pour gérer ses ressources, il y a un écart entre ce dont les institutions sont capables en théorie et en pratique, et plus l'institution est grande, plus sont grands ses coûts.
Je continue mes recherches sur la documentation technique et je vois plein de parallèles possibles avec les institutions. Quelques notes formulées à ma sauce pour mémoire:
-
La documentation du code n'est pas suffisante. Ce n'est qu'une petite partie de ce qu'est la documentation. Elle ne dit pas pourquoi un logiciel change le monde, comment s'impliquer dans la communauté, quelles sont ses valeurs, etc.
-
Votre pire problème, c'est le «moi d'il y a 6 mois». Si je ne documente pas ce que je fais, je ne comprends même plus les choses quelques mois plus tard. Comment imaginer impliquer d'autres personnes, transmettre quelque chose, etc. si je ne m'y retrouve pas?
-
L'ingénieur (développeur) a de grandes connaissances, mais ne veut pas faire l'effort de les transmettre (à l'audience). Dans le modèle traditionnel, les personnes ne sont pas au même niveau et il faut des connecteurs.
-
Dans le monde open source, les développeurs sont souvent aussi l'audience. L'enjeu, ce sont les débutants, comment éviter le jargon, comment être inclusif, etc.?
-
Je le ferai plus tard signifie au fond: cela ne sera jamais fait!
-
Il y avait beaucoup d'utilisateurs (d'un logiciel), mais pas de communauté! Intéressante distinction. Qu'en faire en institution (ecclésiale): qui sont les utilisatrices et utilisateurs, qu'est-ce que la communauté?
-
Un ensemble de compétences au service de la clientèle. C'est la spécificité de Write the Docs dans le monde de la documentation technique. Faire des pauses durant les conférences, c'est aussi le moyen de faire se rencontrer toutes ces personnes.