Modifications

WorkshopDocumentation

3 977 octets supprimés, 30 novembre 2016 à 13:53
Participants
*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 Jb http://fabelier.org/real-time-content-curation/
*Pierre Commenge, Reset http://rzrz.org/
*Damier Day, bibliothécaire
*Thomas Bernardi, PiNG (en pointillé)
*Julien Bellanger, PING (en pointillé, italique)
 
 
[[Fichier:Docugif.gif]]
==Financement/Budget/Besoins==
budget globale, défraiement, hébergement : 12700€
[[media:BudgetWSdocumentation.opensource.ods]]
==Point de départ/problématiques/Intentions/Contexte==
===Constat===
questionnement Questionnement universel des fab lab, hackerspace, et autres ateliers collaboratifs : amener les usagères(ers) à prendre conscience de l'importance de la documentation. cad c'est à dire expliquer, témoignétémoigner, rendre compte du processus de réalisation d'une idée, d'un projet. Et comment inciter les utilisateurs de manière très souple à documenter leurs travaux.
===Intention===
simplifierSimplifier, standardiser, valoriser la démarche de documentationexpliquer pourquoi l'acte de documentation est important et inciter sa réalisation.Proposer une/des méthode (s) les plus souples possible.
===Contexte===
Documenter c'est participer à la constitution d'un savoir commun, qui bénéficie à chacune(un).
==Non organisation/principe de fonctionnementdu workshop==
des Ce temps de travail c'est passé de manière organique : Des humains, du café, des croissants, amateurisme, passion, transpiration
Pas de retro planning, des discussions, de la recherche, des restitutions.
 
des participants en ligne
===des présentations===
* [[WorkshopDocumentation/ProcessusCreatifs|Dispositifs de documentations des processus créatifs]] par JB
*Pair à pairpar Geb : http://etherpad.pingbase.net/FablabDocumentationNotesGeb
*[http://fr.wikipedia.org/wiki/Zotero Zotero] : gestion de références bibliographiques/agrégateurs de flux rss : [http://fr.wikipedia.org/wiki/Netvibes Netvibes], [https://en.wikipedia.org/wiki/Sage_%28Mozilla_Firefox_extension%29 Sage]
*Mise en place d'un centre de documentation à pfc
*[[WorkshopDocumentation/FabmlOntologies|FabMLet ontologies]]
*Semantic wiki ontologie
*optimisation organisationnelle : fablab quebec
===Poster===
*On a commencé un [[PosterDocumentation]] pour inciter les usagers d'un fablab à documenter -> modéle de documentation idéale
 
http://91.68.209.10/bmi/fablabo.net/mediawiki/images/thumb/I_want_to_document.svg/290px-I_want_to_document.svg.jpeg
===Carte heuristique===
===Dépliant===
*On envisage aussi un dépliant qui détaille plus les bonnes pratiques. : basé sur le contenu qui peut-être déployé sur nos pages d'[[Aide:Documenter]] de nos wikis, c'est un [[Depliant Documentation]]
===Fiche idée===
exemple from meuhlab: <br />
[[Fichier:Exemple-fiche idée.png|300px]]<br />
La fiche idée est le premier niveau de documentation : le premier pas  exemple from meuhlab:<gallery>Image:Exemple-fiche idée.png| exemple de MheulabImage:Fiche-idee.png|version vierge</gallery> [http://fablabo.net/mediawiki/images/Fiche_idee.zip télécharger la fiche] en .svg, .pdf et .png<br />[[Fichier:Fiche-ideeFiche_idee_lfo.png|300pxzip ‎]]<br en .svg et .pdf (font V5_myopia) ===FabML/Ontologie===* on a étudié les tenants et les aboutissants de l'ontologie FabML, voir ici : [[WorkshopDocumentation/>FabmlOntologies]] ==Prospectives opérationnelles==
[http://fablabo.net/mediawiki/images/Fiche_idee.zip télécharger la fiche] en svg,pdf et png<br />Que faire après ce workshop?
s'inscrire sur la maillinglist https://groupes.pingbase.net/sympa/subscribe/tous-les-petits-chats-sont-authentiques
recontre un peu plus tard
http://reso-nance.org/whattheflok/ateliers/doc-fablab/accueil
===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 ===centre 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 initialenhancements to the repository and retrieval system. The article thendescribes the FabMoment use scenario as developed at FabFuse2 and appliesit to the initial FabML proposal. This results in four extensions to the initialdescription of the FabML use context.The article concludes with a summary of the requirements for thesemantic design of a FabMoment, and it outlines the next steps for thedevelopment of the semantics of FabML. It also sketches the steps neededfor the development of the technical and practical implementation of FabML. » « As a remedy to the absence of a central repository, the FabML commondescription language was proposed in 2011 [7]. FabML is envisaged to be anset of metadata descriptors for shared Fab Lab projects or FabMoments.FabML is information about a FabMoment that is not part of the projectitself. 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/projecthttp://protospace.nl/fabmomentshttp://fablab-leuven.be/?qressource francophone===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/feedhttp://luzern.fablab.ch/category/projects/feedsources : 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-documentationONTOLOGIESthingiverse API : http://www.thingiverse.com/developersfablab 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.pnghttp://fablab.metamatter.nl/gfx/FabClasses.pngcollection 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 fabricationis_wip (boolean) Optional. Bascule si c'est un work in progress (wip)tags (array) Optional. Mots-clésVOCABULAIREFabML : Fab(lab) Markup LanguageOntologie : « 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%29OPML : Outline Processor Markup Language http://fr.wikipedia.org/wiki/Outline_Processor_Markup_LanguageOWL : 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_LanguageRDF : Resource Description Framework http://fr.wikipedia.org/wiki/Resource_Description_FrameworkRSS : Really Simple Syndication http://fr.wikipedia.org/wiki/RSSXML : Extensible Markup Language http://fr.wikipedia.org/wiki/Extensible_Markup_Language
==Perspectives opérationnels==Mobiliser ensemble des ressources publiques pour financer un centre de ressource dématérialisé qui aurai pour mission :*le developpement informatique autour de l'ontologie pour aboutir à une bonne interropérabilité des documentations* archiver les ressources de l' ensemble des fablabs francophones
===Partage des projets===
Dans l'immédiat
Comment le mettre en place au plus simple (et raffiner affiner 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
Dans un futur indéfini :
un serveur web (fabtruc) aggrège agrè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)
 
 
==== Visualisation des flux ====
: un [[essai de visualisation]] avec socialist jquery
 
====Archivage====
 
Dump wiki avec l'extension git?
====Synchronisation pair à pair====
====Archivage====
Dump wiki
===Prolongement, prochaines rencontres===
retour sur experienceexpérience au-cours du festival [http://reso-nance.org/whattheflok/ WhattheFlok] à Marseille en octobre 2014 Une mailling liste est créée pour prolonger les échanges
==tests divers==
| searchlabel= Dernieres Minutes du Fablab
| title=Projets actifs
| page=noyes| description=Dernieres Minutes de Fablabo}} essai 2 : {{#ask: [[Category:Projets]]| sort=Date de modification| order=descending| format=rss| type=atom| limit=30| searchlabel= Dernieres Minutes du Fablab| title=Projets actifs| page=yes
| description=Dernieres Minutes de Fablabo
}}
==Liens/Sources==
 
* stream entre OA : http://fablabo.net/wiki/WorkshopDocumentation
===Propositions===
Mediamatic<br />
http://www.mediamatic.net/search/251345/en<br />
Open Processing<br />
http://www.openprocessing.org/<br />
Instructables<br />
http://www.instructables.com/<br />
Hannah Perner-Wilson<br />
http://www.plusea.at/?p=1855 <br />
http://kit-of-no-parts.at/<br />
sa thèse au MIT sur la documentation pratique dans un environnement de fabrication libre<br />
http://highlowtech.org/publications/hannahMSthesis.pdf (anglais)<br />
David Mellis<br />
http://web.media.mit.edu/~mellis/cellphone/<br />
Little Bits<br />
http://littlebits.cc/projects<br />
Scratch<br />
http://scratch.mit.edu/starter_projects/<br />
http://reprap.org : le projet reprap
===outils Outils possiblement utiles===*outil ====Outils pour réaliser des docs ====* (pas libre)
http://www.dozuki.com/
*semantique ====Sémantique bordel :====
http://www.omanual.org/
*partage Manuel pour créer et opérer une inter-structure formée de plusieurs Fab Labs (Wiki Sémantique)http://smw.infrastructures.cc/index.php?title=Manuel_pour_créer_et_opérer_une_inter-structure_formée_de_plusieurs_Fab_Labs ====Éditeurs hors ligne pour MediaWiki==== Plugin pour libreOffice permet d'exporter du texte et de créer une page dans un MediaWiki (sans l'import d'image...) http://fr.wikisource.org/wiki/Aide:Guide_de_l%E2%80%99%C3%A9diteur_avanc%C3%A9#Wiki-publisher Voir aussi les possibilités de zim http://zim-wiki.org ====Partage==== *en P2P
http://syncthing.net/
 
*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
http://fabshare.org/
 
*site en cours de dev pour partager des projets finis
http://v3.gitfab.org/
 
====Expériences====
*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)
http://smw.infrastructures.cc/index.php?title=Manuel_pour_créer_et_opérer_une_inter-structure_formée_de_plusieurs_Fab_Labs
*Expériences menées avec Drupal et Wordpress
http://reso-nance.org/wiki/projets/plateforme-lfo/accueil
 
 
==Pads==
 
==La(les) suite(s)==
 
le 30 septembre 2015 eu lieu un autre workshop au faclab :
 
https://hackpad.com/Workshop-Documentation-0XFXLswzMgG
 
dans la foulée David Forgeron a commencer à poser un forma xml commun : https://github.com/daweeed/fabxml
[[category:Workshops]]
15
modifications