Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Travailler un article de fond sur les enjeux de la documentation et de la technique #38

Open
emchateau opened this issue Jun 29, 2020 · 2 comments

Comments

@emchateau
Copy link
Contributor

https://annuel2.framapad.org/p/museadon-9hj9?lang=fr

@emchateau emchateau changed the title Travailler un article de fonds sur les enjeux de la documentation et de la technique Travailler un article de fond sur les enjeux de la documentation et de la technique Jun 29, 2020
@gchetanian
Copy link

gchetanian commented Jul 9, 2020

Pour plus de facilité, je remets ici le mot que j'avais publié le 29 juin dans l'"issue" consacrée aux exemples inspirants :

Bonjour,

Je me permet de partager ici une réflexion qui est à l'état embryonnaire (et donc certainement très maladroite), votre avis m'intéresse néanmoins pour voir si cette direction est intéressante à creuser, je l'ai mis dans cette "issue" bien qu'il s'agisse plus d'une piste de réflexion issue d'articles inspirants que d'exemples inspirants proprement dits.

Dans un article paru en 2007 dans la revue Linux Pratique La chercheuse Isabelle Collet analysait les raison du manque de femmes dans le milieu du développement informatique et en particulier dans la communauté des distributions Linux. Elle observait qu'en informatique les femmes se trouvaient dans les domaines délaissés par les hommes bien que ce soient des femmes qui soient à l'origine des premiers programmes informatiques. Dans un passage elle note la différence de traitement entre la production du code informatique jugée prestigieuse, et occupée en majorité par les hommes, et la production des interfaces et de la documentation jugée secondaire et... occupée majoritairement par des femmes. Elle conclue cependant que "Dans l'avenir, le prestige sera peut-être dans l'écriture d'une documentation de qualité." Ce passage me semble une piste de réflexion intéressante pour muséadon, moins sur la question de la disparité des rôles attribués aux genres que sur la nécessité de soigner les tutoriels et de bien communiquer sur les outils que nous présentons. Cet aspect s'est précisé par la lecture d'articles écrits par l'ethnologue Susan Leigh Star concernant les infrastructures liées aux réseaux informatiques. Dans l'un d'eux elle note comment des défauts de communications et une mauvaise connaissance de l’environnement des informaticiens chargés de développer un réseau collaboratif et des chercheurs censés utiliser ce réseau ont mené à un relatif échec du développement de ce réseau.

Il y a donc pour moi un enjeu important dans la nécessité de bien comprendre et de manipuler les outils que nous allons proposer afin de bien communiquer sur eux. Je crois que cela doit faire partie intégrante de notre travail de muséologue de produire une documentation de qualité afin de transmettre dans le fonds et la forme l'usage de ces outils.

Passage mentionné :
"Une autre particularité du libre est l'importance particulière qui est donnée à la production du code [...]. La conception des interfaces ou la documentation sont jugées moins prestigieuses, plus faciles, demandant moins d'effort que le développement. Il y a bien sûr une part évidente de mauvaise foi dans cette croyance, surtout de la part de ceux qui n'ont que le mot RTFM [Read The Fucking Manual] à la bouche quand on leur pose une question. S'il n'y a qu'à lire le fucking manual, et qu'il est si simple à écrire, qu'ils s'y essaient !

Le fait est, ces zones sont l'enjeu de moins de luttes mais sont fondamentales pour le développement global du logiciel libre. C'est aussi là qu'on retrouve le plus de femmes... c'est la zone qu'on valorise le moins, tel le logiciel il y a 60 ans. Dans l'avenir, le prestige sera peut-être dans l'écriture d'une documentation de qualité." Collet, Isabelle. 2007. « Développeuses en liberté... » Linux pratique, 41, mai 2007. http://articles.mongueurs.net/magazines/linuxpratique41.html.

références :

Collet, Isabelle. 2007. « Développeuses en liberté... » Linux pratique, 41, mai 2007. http://articles.mongueurs.net/magazines/linuxpratique41.html.
Star, Susan Leigh, et Karen Ruhleder. 2010. « Vers une écologie de l’infrastructure ». Revue d’anthropologie des connaissances 4 (1) : 114‑61. https://www.cairn.info/revue-anthropologie-des-connaissances-2010-1-page-114.htm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants
@emchateau @gchetanian and others