WorkshopDocumentation : Différence entre versions

De fablabo
Aller à : navigation, rechercher
(FabML/Ontologie : première rédaction)
(Participants)
 
(53 révisions intermédiaires par 7 utilisateurs non affichées)
Ligne 17 : Ligne 17 :
 
*Marc-Olivier Ducharme, de l’Echofab (Québec)http://www.echofab.org/ et http://fablabs-quebec.org/ / http://wiki.fablabs-quebec.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/
 
*Aurélie Lethuillier, du FAB44  (Saint-Nazaire) http://lefab44.com/
*Jean-Baptiste Labrune, du MIT http://fabelier.org/real-time-content-curation/
+
*Jb http://fabelier.org/real-time-content-curation/
 
*Pierre Commenge, Reset http://rzrz.org/
 
*Pierre Commenge, Reset http://rzrz.org/
 
*Damier Day, bibliothécaire
 
*Damier Day, bibliothécaire
Ligne 25 : Ligne 25 :
 
*Thomas Bernardi, PiNG (en pointillé)
 
*Thomas Bernardi, PiNG (en pointillé)
 
*Julien Bellanger, PING (en pointillé, italique)
 
*Julien Bellanger, PING (en pointillé, italique)
 +
 +
 +
[[Fichier:Docugif.gif]]
  
 
==Financement/Budget/Besoins==
 
==Financement/Budget/Besoins==
Ligne 31 : Ligne 34 :
 
budget globale, défraiement, hébergement : 12700€
 
budget globale, défraiement, hébergement : 12700€
  
 
+
[[media:BudgetWSdocumentation.opensource.ods]]
  
 
==Point de départ/problématiques/Intentions/Contexte==
 
==Point de départ/problématiques/Intentions/Contexte==
Ligne 37 : Ligne 40 :
 
===Constat===
 
===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.
+
Questionnement universel des fab lab, hackerspace, et autres ateliers collaboratifs : amener les usagères(ers) à prendre conscience de l'importance de la documentation. c'est à dire expliquer, 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===
 
===Intention===
 
    
 
    
simplifier, standardiser, valoriser la démarche de documentation
+
Simplifier, standardiser, valoriser la démarche de documentation
expliquer pourquoi l'acte de documentation est important et inciter sa réalisation
+
expliquer pourquoi l'acte de documentation est important et inciter sa réalisation.
 +
Proposer une/des méthode (s) les plus souples possible.
  
 
===Contexte===
 
===Contexte===
Ligne 48 : Ligne 52 :
 
Documenter c'est participer à la constitution d'un savoir commun, qui bénéficie à chacune(un).
 
Documenter c'est participer à la constitution d'un savoir commun, qui bénéficie à chacune(un).
  
==Non organisation/principe de fonctionnement==
+
==Non organisation/principe de fonctionnement du workshop==
  
des humains, du café, des croissants, amateurisme, passion, transpiration
+
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.
 
Pas de retro planning, des discussions, de la recherche, des restitutions.
 +
 +
des participants en ligne
  
 
===des présentations===
 
===des présentations===
*Dispositifs de documentations processus créatifs
+
* [[WorkshopDocumentation/ProcessusCreatifs|Dispositifs de documentations des processus créatifs]] par JB
*Pair à pair
+
* Pair à pair par 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]
 
*[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
 
*Mise en place d'un centre de documentation à pfc
*FabML
+
* [[WorkshopDocumentation/FabmlOntologies|FabML et ontologies]]
 
*Semantic wiki ontologie
 
*Semantic wiki ontologie
 
*optimisation organisationnelle : fablab quebec
 
*optimisation organisationnelle : fablab quebec
Ligne 68 : Ligne 74 :
 
===Poster===
 
===Poster===
 
*On a commencé un [[PosterDocumentation]] pour inciter les usagers d'un fablab à documenter -> modéle de documentation idéale
 
*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===
 
===Carte heuristique===
Ligne 75 : Ligne 83 :
  
 
===Dépliant===
 
===Dépliant===
*On envisage aussi un dépliant qui détaille plus les bonnes pratiques. : [[Aide:Documenter]]
+
*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===
 
===Fiche idée===
exemple from meuhlab: <br />
 
[[Fichier:Exemple-fiche idée.png|300px]]<br />
 
  
version vierge:<br />
+
La fiche idée est le premier niveau de documentation : le premier pas
[[Fichier:Fiche-idee.png|300px]]<br />
+
 
 +
exemple from meuhlab:
 +
<gallery>
 +
Image:Exemple-fiche idée.png| exemple de Mheulab
 +
Image: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_idee_lfo.zip ‎]] 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)
+
===centre de ressource francophone===
 
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==
+
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===
 
===Partage des projets===
Ligne 208 : Ligne 123 :
  
 
Dans l'immédiat
 
Dans l'immédiat
Comment le mettre en place au plus simple (et raffiner par la suite)?  
+
Comment le mettre en place au plus simple (et affiner par la suite)?  
 
-> construire un flux rss à partir de son outil de publication qui comprenne quelques champs communs comme  
 
-> construire un flux rss à partir de son outil de publication qui comprenne quelques champs communs comme  
  - nom du projet,
+
* nom du projet,
  - url vers une image vignette,
+
* url vers une image vignette,
  - description courte,
+
* description courte,
  - url vers la page sur le site original,
+
* url vers la page sur le site original,
 
-> ajouter une page sur son wiki qui présente référence ce(s) flux  
 
-> 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
 
Ces flux peuvent être rassemblés par différents moyens (sur ordi avec thunderbird, firefox, etc.), sur un serveur web
Ligne 224 : Ligne 139 :
  
 
Dans un futur indéfini :  
 
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 .
+
un serveur web (fabtruc) 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)
 
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====
 
====Synchronisation pair à pair====
====Archivage====
 
  
Dump wiki
 
  
 
===Prolongement, prochaines rencontres===
 
===Prolongement, prochaines rencontres===
retour sur experience
+
retour sur expé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==
 
==tests divers==
Ligne 251 : Ligne 174 :
 
| searchlabel= Dernieres Minutes du Fablab
 
| searchlabel= Dernieres Minutes du Fablab
 
| title=Projets actifs
 
| title=Projets actifs
| page=no
+
| page=yes
 +
| 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
 
| description=Dernieres Minutes de Fablabo
 
}}
 
}}
Ligne 264 : Ligne 200 :
  
 
==Liens/Sources==
 
==Liens/Sources==
 
* stream entre OA : http://fablabo.net/wiki/WorkshopDocumentation
 
  
 
===Propositions===
 
===Propositions===
Ligne 283 : Ligne 217 :
  
  
 +
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 possiblement utiles===
+
===Outils possiblement utiles===
*outil pour réaliser des docs (pas libre)
+
====Outils pour réaliser des docs====
 +
* (pas libre)
 
http://www.dozuki.com/  
 
http://www.dozuki.com/  
  
*semantique bordel :
+
====Sémantique bordel====
 
http://www.omanual.org/
 
http://www.omanual.org/
  
*partage en P2P
+
*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/  
 
http://syncthing.net/  
 +
 
*Rekall est un environnement open-source pour documenter, analyser les processus de création et simplifier la reprise des oeuvres.
 
*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
 
https://github.com/Rekall/Rekall
 +
 
*centralise des liens vers des outils de partages
 
*centralise des liens vers des outils de partages
 
http://fabshare.org/
 
http://fabshare.org/
 +
 
*site en cours de dev pour partager des projets finis
 
*site en cours de dev pour partager des projets finis
 
http://v3.gitfab.org/
 
http://v3.gitfab.org/
 +
 +
====Expériences====
 
*Propose des step by step pour réaliser des projets.
 
*Propose des step by step pour réaliser des projets.
 
http://www.wikihow.com/Main-Page
 
http://www.wikihow.com/Main-Page
 +
 
*Recueil de projets documentés :
 
*Recueil de projets documentés :
 
http://www.kisskissbankbank.com/catalogue-20-objets-a-realiser-en-design-libre
 
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
 
*Expériences menées avec Drupal et Wordpress
Ligne 314 : Ligne 286 :
  
 
http://reso-nance.org/wiki/projets/plateforme-lfo/accueil
 
http://reso-nance.org/wiki/projets/plateforme-lfo/accueil
 
 
  
 
==Pads==
 
==Pads==
Ligne 338 : Ligne 308 :
  
  
 +
 +
==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]]
 
[[category:Workshops]]

Version actuelle en date du 30 novembre 2016 à 14:53

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

Participants


Docugif.gif

Financement/Budget/Besoins

Dans le cadre de Nantes Digital Week, Nantes Metropole, Organisation Internationnal de la Francophonie
budget globale, défraiement, hébergement : 12700€

media:BudgetWSdocumentation.opensource.ods

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. c'est à dire expliquer, 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

Simplifier, standardiser, valoriser la démarche de documentation expliquer 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 fonctionnement du workshop

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

Realisations

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

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.

Suggestion d'ontologie et de propriétés sémantiques

Fichier:FabLabDocumentationMAP.mm

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

La fiche idée est le premier niveau de documentation : le premier pas

exemple from meuhlab:

télécharger la fiche en .svg, .pdf et .png
Fichier:Fiche idee lfo.zip en .svg et .pdf (font V5_myopia)

FabML/Ontologie

Prospectives opérationnelles

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


centre de ressource francophone

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

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 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

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) 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

Prolongement, prochaines rencontres

retour sur expérience au-cours du festival WhattheFlok à Marseille en octobre 2014

Une mailling liste est créée pour prolonger les échanges

tests divers

un flux Atom à l'aide de semantic mediawiki

FLux RSS des projets de fablabo.net :

Dernieres Minutes du Fablab

essai 2 : Dernieres Minutes du Fablab

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

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

Mediamatic
http://www.mediamatic.net/search/251345/en
Open Processing
http://www.openprocessing.org/
Instructables
http://www.instructables.com/
Hannah Perner-Wilson
http://www.plusea.at/?p=1855
http://kit-of-no-parts.at/
sa thèse au MIT sur la documentation pratique dans un environnement de fabrication libre
http://highlowtech.org/publications/hannahMSthesis.pdf (anglais)
David Mellis
http://web.media.mit.edu/~mellis/cellphone/
Little Bits
http://littlebits.cc/projects
Scratch
http://scratch.mit.edu/starter_projects/

http://reprap.org : le projet reprap

Outils possiblement utiles

Outils pour réaliser des docs

  • (pas libre)

http://www.dozuki.com/

Sémantique bordel

http://www.omanual.org/

  • 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

  • Expériences menées avec Drupal et Wordpress

http://protospace.nl

  • 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

http://etherpad.pingbase.net/PosterDocumentation

http://etherpad.pingbase.net/FablabDocumentationNotesGeb

Notes

Phase.deux.jpg Phase.un.JPG


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