WorkshopDocumentation
Cette page est la trace d'une semaine travail sur le sujet de la documentation dans les fablabs.
Qui eu lieu en septembre 2014 à PlateformeC
Sommaire
Participants
- Thiery Mbaye, de Meuhlab (Lille) http://www.meuhlab.org/ + http://lille-makers.org/
- Guillaume Brunet, de Labomedia (Orléans) http://wiki.labomedia.org/
- David Forgeron du Carrefour numérique de Cité des sciences (Paris) http://cyberweb.cite-sciences.fr/fablab/wiki/doku.php?id=index
- Sonia Christon de la bibliothèque de la Cité de Sciences
- Fenshu & Jerome Abel - reso-nance numérique (Marseille) - http://reso-nance.org/ - http://reso-nance.org/wiki/projets/plateforme-lfo/accueil
- Koffi Dodji Honou, de Woelab (Lomé – Togo) http://www.woelabo.com/index.html
- Mouhamadou Ngom, de Ker Thiossane (Dakar – Sénégal) http://fablab.ker-thiossane.org/index.php?title=Accueil
- Mathieu Goessens, de Breizh entropy (Rennes) - http://wiki.breizh-entropy.org http://breizh-entropy.org/
- Marc-Olivier Ducharme, de l’Echofab (Québec)http://www.echofab.org/ et http://fablabs-quebec.org/ / http://wiki.fablabs-quebec.org
- Aurélie Lethuillier, du FAB44 (Saint-Nazaire) http://lefab44.com/
- Jean-Baptiste Labrune, du MIT http://fabelier.org/real-time-content-curation/
- Pierre Commenge, Reset http://rzrz.org/
- Damier Day, bibliothécaire
- Cédric Doutriaux, PiNG
- Romain Di Vozzo, Fablab Digiscope, (Gif-sur-Yvette/Saclay) (à distance)
- Samuel Huron, Fabelier (à distance)
- Thomas Bernardi, PiNG (en pointillé)
- Julien Bellanger, PING (en pointillé, italique)
Financement/Budget/Besoins
Dans le cadre de Nantes Digital Week, Nantes Metropole, Organisation Internationnal de la Francophonie
budget globale, défraiement, hébergement : 12700€
Point de départ/problématiques/Intentions/Contexte
Constat
questionnement universel des fab lab, hackerspace, et autres ateliers collaboratifs : amener les usagères(ers) à prendre conscience de l'importance de la documentation. cad expliquer, témoigné, rendre compte du processus de réalisation d'une idée, d'un projet.
Intention
simplifier, standardiser, valoriser la démarche de documentation expliquer pourquoi l'acte de documentation est important et inciter sa réalisation
Contexte
Documenter c'est participer à la constitution d'un savoir commun, qui bénéficie à chacune(un).
Non organisation/principe de fonctionnement
des humains, du café, des croissants, amateurisme, passion, transpiration Pas de retro planning, des discussions, de la recherche, des restitutions.
des présentations
Realisations
Poster
- On a commencé un PosterDocumentation pour inciter les usagers d'un fablab à documenter -> modéle de documentation idéale
Carte heuristique
Nous avons déterminé les caractéristiques souhaitables lors de la documentation des projets, des personnes, des process et des machines en Fab Lab. Cette caractérisation peut être utilisée comme base pour créer un des formulaires et modèles SemanticWiki qui pourraient être partagés entre Fab Lab et ainsi favoriser l'inter-opérabilité des documentations.
Fichier:FabLabDocumentationMAP.mm
Dépliant
- On envisage aussi un dépliant qui détaille plus les bonnes pratiques. : Aide:Documenter
Fiche idée
exemple from meuhlab:
version vierge:
télécharger la fiche en svg,pdf et png
FabML/Ontologie
- on a étudié les tenants et les aboutissants de l'ontologie FabML
ML comme «markup language» comme dans HTML (HyperText Markup Language), XML (Extensible Markup Language)
FabML part d'un constat :
- les fablabs utilisent déjà différents CMS (wordpress, mediawiki, drupal), - la centralisation d'informations de tous les fablabs n'est pas un but réaliste - externaliser la documentation sur des plateformes existantes comme thingiverse ou instructables n'est pas une solution viable :
- ils sont animés par des sociétés commerciales dont les bonnes intentions peuvent évoluer, - ces plateformes ne sont pas open-source donc pas installables sur des serveurs autonomes, - héberger sa documentation sur le réseau peut-être un souci pour les fablabs qui ont des difficultés d'accès à internet.
Et propose une manière légère pour que la documentation puisse circuler entre les fablabs. par l'adoption de formats pour l'échange d'informations : d'abord à partir de flux RSS simples, puis en structurant ces flux par des éléments xml.
Chaque groupe / fablab a son propre dépôt de documentation de projets ("fabmoments") FabML propose d'échanger des "fabmoments", par un méta-langage de balisage.
«Developing open & distributed tools for Fablab project documentation» (2010)
Analyse à partir de 3 lieux : Protospace (Utrecht), Swiss Fablab (Lucerne), fabfolk.com (n'existe plus en 2014 ?) Description à partir de ces cas sans rentrer dans le détail
«A Next Step Towards FabML» (2013)
Cet article décrit un cas pour illustrer l'intérêt d'un langage commun pour partager les ressources des fablabs, il fait aussi le constat des difficultés rencontrées pour intégrer la documentation (qu'on a pu aussi discuter)
Mais rien de nouveau sur le langage de balisage en lui-même....
« Fab Labs often choose their own website as the primary repository for their project documentation, also known as FabMoments. FabML has been proposed as a meta language to describe FabMoments across repositories. This proposal has been validated at the FabFuse2 conference in Amersfoort in 2013, and a narrative of a possible use scenario has been developed to further detail the initial FabML proposal. »
« This article presents the initial FabML use context, as proposed earlier, which consists of a sharing part, a retrieval part, and some initial enhancements to the repository and retrieval system. The article then describes the FabMoment use scenario as developed at FabFuse2 and applies it to the initial FabML proposal. This results in four extensions to the initial description of the FabML use context. The article concludes with a summary of the requirements for the semantic design of a FabMoment, and it outlines the next steps for the development of the semantics of FabML. It also sketches the steps needed for the development of the technical and practical implementation of FabML. »
« As a remedy to the absence of a central repository, the FabML common description language was proposed in 2011 [7]. FabML is envisaged to be an set of metadata descriptors for shared Fab Lab projects or FabMoments. FabML is information about a FabMoment that is not part of the project itself. Examples could be the name of the creator of the FabMoment, machines, processes, settings and materials used in realizing the project, types of source files available, etc. »
« FabCenter, Webapplication to support users and administrators of Fablabs with creating and sharing documentation »
Mémoire de thèse. Commence par décrire et comparer différents systèmes de documentation collective pour les fablabs : fabML, fabiji, thingiverse, buildlog, instructables Puis décrit son système : Fabcenter (qui utilise thingiverse)
« There are three labs aggregating their information (FAU Nuernberg , FabLab Utrecht , FabLab-Leuven ) through exchangeing RSS-feeds » http://fablab.fau.de/project http://protospace.nl/fabmoments http://fablab-leuven.be/?q=aggregated-fabmoments
Le fablab de Leuven aggrège 3 flux : http://www.fablab-leuven.be/gallery/rss (qui ne marche pas...) http://fablab.waag.org/fabmoments/feed http://luzern.fablab.ch/category/projects/feed sources :
Developing open & distributed tools for Fablab project documentation (2010) http://ceur-ws.org/Vol-739/paper_21.pdf
http://wiki.fablab.is/wiki/Making_the_case_for_FabML (2011)
FabCenter, Webapplication to support users and administrators of Fablabs with creating and sharing documentation http://hci.rwth-aachen.de/materials/publications/hemig2013a.pdf
A Next Step Towards FabML: A narrative for knowledge sharing use cases in Fab Labs http://www.fablabinternational.org/system/resources/BAhbBlsHOgZmSSItMjAxNC8wNS8zMC8xNi8xNy81NC83NDIvVHJveGxlcl9aaWpwLnBkZgY6BkVU/Troxler%20Zijp.pdf
Un workshop de Peter Troxler en 2013 à Fabfuse 2, mais l'URL ne fonctionne plus et impossible de le trouver en ligne : http://192.168.178.87:9001/p/FabFuse2_Common_Description_Language
http://fr.slideshare.net/AnuMaa/okfest-fablab-project-documentation ONTOLOGIES thingiverse API : http://www.thingiverse.com/developers fablab ontology (Frysklab fablab) : http://fablab.metamatter.nl/ open manual format : http://www.omanual.org/ mindmap : https://www.mindmup.com/#m:a1abadb08020870132790312f982e2670b
http://fablab.metamatter.nl/gfx/fablabDomain.png http://fablab.metamatter.nl/gfx/FabClasses.png collection d'ontologies diverses : http://www.schema.org/
http://www.wikidata.org/wiki/Wikidata:Introduction
Catégories (plutôt qu'ontologie) de thingiverse (d'après l'API : http://www.thingiverse.com/developers/rest-api-reference#things ) exemple : http://www.thingiverse.com/thing:190923
name (string) - Optional. license (string) Optional. Parmi cc, cc-sa, cc-nd, cc-nc-sa, cc-nc-nd, pd0, gpl, lgpl, bsd. category (string) Optional. (ex: "3D Printer Parts") description (string) Optional. instructions (string) Optional. Notice de fabrication is_wip (boolean) Optional. Bascule si c'est un work in progress (wip) tags (array) Optional. Mots-clés VOCABULAIRE FabML : Fab(lab) Markup Language Ontologie : « ensemble structuré des termes et concepts représentant le sens d'un champ d'informations, que ce soit par les métadonnées d'un espace de noms, ou les éléments d'un domaine de connaissances. L'ontologie constitue en soi un modèle de données représentatif d'un ensemble de concepts dans un domaine, ainsi que des relations entre ces concepts. » http://fr.wikipedia.org/wiki/Ontologie_%28informatique%29 OPML : Outline Processor Markup Language http://fr.wikipedia.org/wiki/Outline_Processor_Markup_Language OWL : sigle réarrangé de Web Ontology Language, « langage d'ontologie web », langage informatique utilisé pour modéliser des ontologies, ensemble de concepts et connaissances http://fr.wikipedia.org/wiki/Web_Ontology_Language RDF : Resource Description Framework http://fr.wikipedia.org/wiki/Resource_Description_Framework RSS : Really Simple Syndication http://fr.wikipedia.org/wiki/RSS XML : Extensible Markup Language http://fr.wikipedia.org/wiki/Extensible_Markup_Language
Perspectives opérationnels
Partage des projets
Flux
Qu'est ce qu'on pourrait faire pour le partage des projets?
Dans l'immédiat Comment le mettre en place au plus simple (et raffiner par la suite)? -> construire un flux rss à partir de son outil de publication qui comprenne quelques champs communs comme
- nom du projet, - url vers une image vignette, - description courte, - url vers la page sur le site original,
-> ajouter une page sur son wiki qui présente référence ce(s) flux Ces flux peuvent être rassemblés par différents moyens (sur ordi avec thunderbird, firefox, etc.), sur un serveur web
En parallèle puis dans un second temps : Mettre en place des modèles de pages structurées sémantiquement sur les différents wikis, ce qui permettra d'exporter des flux xml structurés. Quel intérêt à avoir des flux xml structurés? -> pouvoir poser des questions comme : je cherche un objet sonore à construire en bois, sans électronique et sans découpeuse laser. -> avoir un ensemble cohérent de documents par projet (journal de bord, photographies, fichiers de fabrication numérique, etc.) facile à télécharger
Dans un futur indéfini : un serveur web (fabtruc) aggrège ces différents flux, rassemble les fichiers joints (synchronisés avec chaque site). On peut chercher sur fabtruc, accéder aux documents locaux ou au site d'origine et exporter un projet complet vers son serveur de fablab (en gardant une trace de la généalogie . Pour ça il faudrait développer des "plugins" d'import pour mediawiki/dokuwiki (une sorte d'API d'upload)
Synchronisation pair à pair
Archivage
Dump wiki
Prolongement, prochaines rencontres
retour sur experience
tests divers
un flux Atom à l'aide de semantic mediawiki
FLux RSS des projets de fablabo.net :
un flux RSS dans Dokuwiki
L'exemple des projets du Carrefour Numérique : http://carrefour-numerique.cite-sciences.fr/fablab/wiki/feed.php?ns=projets
Tests pour du partage de contenu en peer-to-peer
Workshop documenté sur sa propre page wiki: WorkshopDocumentation/Partage-De-Contenu-Peer-to-Peer
Liens/Sources
* stream entre OA : http://fablabo.net/wiki/WorkshopDocumentation
Propositions
- presque ce que on a dit :
http://prezi.com/4vvwrvwqr4k6/documentation-fab-lab/
- vision machine qui documente tout seul...
http://fr.slideshare.net/AnuMaa/okfest-fablab-project-documentation
- Consigne de synthese de documentation (fasciste)
http://fablabdigiscope.wordpress.com/documentation/
- Cnrs consigne de documentation, verification, validation.
http://www.dsi.cnrs.fr/conduite-projet/phasedeveloppement/qualite/gestion-doc/basdevqual2.htm
de bons sites de documentation
outils possiblement utiles
- outil pour réaliser des docs (pas libre)
- semantique bordel :
- partage en P2P
- Rekall est un environnement open-source pour documenter, analyser les processus de création et simplifier la reprise des oeuvres.
https://github.com/Rekall/Rekall
- centralise des liens vers des outils de partages
- site en cours de dev pour partager des projets finis
- Propose des step by step pour réaliser des projets.
http://www.wikihow.com/Main-Page
- Recueil de projets documentés :
http://www.kisskissbankbank.com/catalogue-20-objets-a-realiser-en-design-libre
- Manuel pour créer et opérer une inter-structure formée de plusieurs Fab Labs (Wiki Sémantique)
- Expériences menées avec Drupal et Wordpress
- expériences docuWiki mediawiki
http://fablabo.net/wiki/DataFab sémantique
http://reso-nance.org/wiki/projets/plateforme-lfo/accueil
Pads
Pages de prises de notes, créent au fur et à mesure... du brouillon, des idées...
http://etherpad.pingbase.net/FablabDocumentation
http://etherpad.pingbase.net/FablabDocumentation-Methodologie
http://etherpad.pingbase.net/FablabDocumentation-quoi
Notes
