WorkshopDocumentation

De fablabo

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