![\"\"](\"http:\/\/carrefour-numerique.cite-sciences.fr\/blog\/wp-content\/uploads\/2014\/08\/groupe-650x477.jpg\")
<\/p>\nMardi 29 juillet 2014, une petite dizaine de personnes d\u00e9termin\u00e9es et peut-\u00eatre m\u00eame un peu t\u00e9m\u00e9raires se sont r\u00e9unies pour discuter de la documentation des projets r\u00e9alis\u00e9s au sein d\u2019un Fab Lab. \u00c9tonnamment, bien que le sujet ne soit pas des plus amusants, les \u00e9changes \u00e9taient denses. Focus sur l\u2019une des questions soulev\u00e9e : c\u2019est quoi documenter et pourquoi s\u2019en donner la peine ?<\/b><\/p>\n
<\/p>\n
Matthieu, ancien biblioth\u00e9caire jeunesse, d\u00e9sormais m\u00e9diateur du Fab Lab<\/a> du Carrefour Num\u00e9rique\u00b2 est \u00e0 l\u2019initiative de ce Meet-up<\/span><\/a> (rencontre sur une th\u00e9matique annonc\u00e9e sur le r\u00e9seau social du m\u00eame nom) sp\u00e9cial \u00ab Documentation \u00bb<\/a>. Sa motivation vient de sa pratique du terrain et d\u2019un constat :<\/p>\n \u00ab Certain\u00b7e\u00b7s utilisateur\u00b7trice\u00b7s prennent des notes sur un calepin et ne les partagent pas avec les autres. D’autres posent des questions alors que l’information est mise sur notre Wiki<\/a> (site web collaboratif, NDLR). Alors comment faire comprendre que c’est utile de documenter et de partager ? \u00bb<\/p><\/blockquote>\n Les profils des personnes qui se sont retrouv\u00e9es pour ce temps de discussion \u00e9taient vari\u00e9s et r\u00e9v\u00e8lent combien le sujet est partag\u00e9. Il y avait des personnes issues du domaine de la documentation et des biblioth\u00e8ques, fr\u00e9quentant des Fab Labs ou bricolant chez eux, de l\u2019ing\u00e9nierie et de l\u2019informatique, ou encore de l\u2019animation socio-culturelle et technique.<\/p>\n Pour permettre \u00e0 tout ce petit monde de s\u2019assurer qu\u2019on parlait de la m\u00eame chose, chacun\u00b7e a expliqu\u00e9 dans son jargon respectif ce que recouvrait le terme \u00ab documenter \u00bb et ce qu\u2019il ou elle en attendait. Petit tour d’horizon :<\/p>\n Toutes les personnes pr\u00e9sentes autour de cette table, partant de leurs propres v\u00e9cus, semblaient convaincues de l\u2019utilit\u00e9 de documenter\u2026 mais rapidement s\u2019est pos\u00e9e la question de celles et ceux qui ne documentent pas. Avouons-le,\u00a0documenter c\u2019est\u00a0 contraignant et il existe de nombreux freins (le temps, l\u2019\u00e9crit, la prise en main de l\u2019outil, le choix d\u2019une licence d\u2019exploitation\u2026). La petite \u00e9quipe a donc essay\u00e9 de lister des arguments pour permettre \u00e0 chacun\u00b7e de mieux saisir les enjeux et de contribuer au partage de savoirs.<\/p>\n Il en ressort que la documentation \u00e7a peut servir, \u00e0 toi utilisateur\u00b7trice qui ne consulte pas et\/ou ne r\u00e9alise pas encore la documentation de tes projets, \u00e0 :![\"\"](\"http:\/\/carrefour-numerique.cite-sciences.fr\/blog\/wp-content\/uploads\/2014\/08\/notes-650x477.jpg\")
<\/p>\n\n
tout simplement de pouvoir refaire ce qui a \u00e9t\u00e9 fait par d’autres, d\u2019avoir la recette de cuisine.<\/q><\/li>\n
trouver des infos pour pourvoir reproduire le projet avec des publics. Des infos sur le mat\u00e9riel n\u00e9cessaire pour r\u00e9aliser telle ou telle chose, o\u00f9 acheter le mat\u00e9riel ? Pour quel ordre de prix ?<\/q><\/li>\n
avec tel projet j’ai appris \u00e0 faire \u00e7a ou \u00e7a<\/q> ou
avec ce projet vous apprendrez \u00e7a<\/q>. La documentation gagnerait \u00e0 ne pas \u00eatre que techno-centr\u00e9e. Elle pourrait \u00eatre l\u00e0 pour favoriser le partage de connaissances en indiquant les notions abord\u00e9es, les pr\u00e9-requis n\u00e9cessaires mais aussi les essai-erreurs. Une personne peut vouloir rechercher un projet en se disant
tiens quel projet me permettrai de comprendre le principe de r\u00e9sistance \u00e9lectrique ?<\/q> par exemple.<\/li>\n
la documentation c’est super important. On doit y trouver, le \u201ccomment marche le logiciel ?\u201d pour les d\u00e9veloppeurs et le\u00a0\u201ccomment l’utiliser ?\u201d pour les utilisateurs. J’ai donc tendance, dans la documentation que je fais au Fab Lab, \u00e0 vouloir expliquer mes choix, le \u201cpourquoi j\u2019ai fait \u00e7a comme \u00e7a ?\u201d<\/q><\/li>\n
la documentation est le point de coordination et de conciliation des acteurs d’un projet. Avec les cycles it\u00e9ratifs ou agiles, les m\u00e9thodes agiles de d\u00e9veloppement, on fonctionne par essai-erreur (it\u00e9rations) et selon les retours on r\u00e9ajuste. La documentation y est aussi importante<\/q>.<\/li>\n
documenter c’est aller chercher l’information d\u00e9j\u00e0 existante sur un sujet, ce n’est pas cr\u00e9er de l’information, c’est la rendre accessible et la question de l\u2019indexation est clef<\/q>.<\/li>\n<\/ul>\n
![\"\"](\"http:\/\/carrefour-numerique.cite-sciences.fr\/blog\/wp-content\/uploads\/2014\/08\/prise_note-650x477.jpg\")
<\/p>\n
\n<\/b><\/p>\n\n
![\"\"](\"http:\/\/carrefour-numerique.cite-sciences.fr\/blog\/wp-content\/uploads\/2014\/08\/notes2-650x477.jpg\")
<\/p>\n