Aide:Documenter : Différence entre versions

(La documentation : un principe fondateur des fablabs)
 
(32 révisions intermédiaires par 7 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
Le bonnes pratiques pour documenter une activité dans le fablab
+
 
 +
 
 +
==La documentation : un principe fondateur des fablabs==
 +
<br />
 +
 
 +
'''Comme cela est indiqué dans la [http://fablabo.net/wiki/Charte_des_Fablabs charte du MIT], le partage des connaissances et des savoirs-faire est un principe de base des fablabs : les usagers s'engagent à "contribuer à la documentation et à l'acquisition des connaissances".'''
  
 
==Pourquoi documenter?==
 
==Pourquoi documenter?==
 +
<br />
  
les bonnes raisons
+
'''- Partager du savoir'''
 +
Dans l'esprit de la culture libre, et parce que vous avez certainement déjà profité de la documentation d'autres personnes, votre documentation permettra à d'autres usagers de refabriquer, améliorer ou adapter votre réalisation.
  
les motivations
+
'''- Gagner du temps'''
 +
Documenter son projet et ses différentes étapes permet de se souvenir de ce que l'on a déjà fait et de ne pas refaire les mêmes erreurs.
  
==à partir de quand documenter?==
+
'''- Avoir des retours'''
 +
Souvent au cours de l'élaboration d'un projet, on a besoin de l'aide d'autres usagers : une documentation détaillée leur permettra de bien le comprendre et donc de vous aider plus efficacement. 
  
qu'est-ce qui vaut le coup?
+
'''- Éviter de se blesser ou d'abîmer du matériel'''
 +
Une bonne documentation de l'utilisation des machines et des outils permet d'améliorer la sécurité dans les ateliers.
  
"chaque petit chat est authentique"
+
==Que documenter ?==
  
Quand c'est utile à soit/ aux autres
 
  
==Que documenter?==
+
Sur ce wiki vous pouvez documenter vos travaux personnels ou collectifs (étapes, matériaux et machines utilisées, difficultés rencontrées, etc) mais aussi :
  
*un Projet
+
- contribuer aux [[http://fablabo.net/wiki/Machines | pages d'utilisation des machines]] (astuces, réglages, etc),
*une page ressource
 
**sur une machine
 
**sur un logiciel
 
**sur un matériel
 
**politique
 
**culturelle
 
*un atelier pédagogique
 
  
==Comment et quand documenter? Quelles informations mettre dans sa documentation ? ==
+
- partager des tutoriaux, des astuces techniques, des informations sur le fonctionnement de logiciels, sur le travail de certains matériaux,
 +
 
 +
- compléter les pages d'informations de la partie "À propos des fablabs".
 +
 
 +
 
 +
De manière générale, n'hésitez pas à corriger ou améliorer le contenu déjà présent dans ce wiki.
 +
 
 +
 
 +
==Comment et quand documenter? Quelles informations mettre dans sa documentation ?==
  
 
===Avant : exposer son idée===
 
===Avant : exposer son idée===
 +
 +
Exposer son idée permet de se l'exprimer clairement à soi même, et facilite la communication du projet à d'autres personnes susceptibles de vous aider
  
 
Fiche-idée papier ou scannée ?
 
Fiche-idée papier ou scannée ?
Ligne 42 : Ligne 54 :
 
===Pendant : faire un journal de bord===
 
===Pendant : faire un journal de bord===
  
Pas à pas, l'expérience avec les essais erreurs.
+
Pas à pas, documenter l'expérience avec les essais ou les problèmes rencontrés et leurs résolutions.
  
===A la fin : présenter le projet finalisé===
+
Le cahier de laboratoire ou journal de bord permet de se souvenir des étapes de recherches, de garder des traces pour soi-même et éventuellement d'autres personnes qui travailleront sur ce sujet.
 +
 
 +
===À la fin : présenter le projet finalisé===
  
 
Raffiner le travail du journal de bord pour le rendre lisible et pour valoriser le projet.
 
Raffiner le travail du journal de bord pour le rendre lisible et pour valoriser le projet.
 
 
En gras : les éléments indispensables à mettre dans une documentation
 
En gras : les éléments indispensables à mettre dans une documentation
  
Ligne 67 : Ligne 80 :
 
*Réalisation (=> conception)
 
*Réalisation (=> conception)
  
 +
//medias supports//
  
//medias supports//
 
  
 
==Bonnes Pratiques/ Références/Mise en page==
 
==Bonnes Pratiques/ Références/Mise en page==
  
 +
===Dépliant : faire, documenter, partager===
  
===Affiche Licence===
+
[[File:documentationfablab-depliant-recto.jpeg|620px]]
 +
[[File:documentationfablab-depliant-verso.jpeg|620px]]
  
 +
Ce dépliant tiré de cette page [[Media:DepliantVraimentLibre.svg]]
  
[[Fichier:Licences.jpg|400px]] <br />
+
Il a été réalisé suite à une session de travail à Marseille [http://reso-nance.org/whattheflok/ateliers/doc-fablab/accueil en octobre 2014]
  
[[http://fablabo.net/mediawiki/images/Licences.pdf fichier pdf]]<br />
+
Une nouvelle version est publiée ici : http://reso-nance.org/files/lfo/docfablab/
[[Media:Licences pfc.svg fichier svg]]<br />
+
Version plus aboutie [[Fichier:Depliant.documentation.zip]]
  
  
 +
===Affiche Licence===
  
===Liens Projets/présentations===
+
[[Fichier:Licences.jpg|400px]] <br />
  
Mediamatic<br />
+
[[Media:Licences.pdf]]<br />
http://www.mediamatic.net/search/251345/en<br />
+
[[Media:Licences pfc.svg]]<br />
Open Processing<br />
+
[[Media:Typos.zip]]
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 />
 

Version actuelle en date du 7 novembre 2017 à 17:00


La documentation : un principe fondateur des fablabs


Comme cela est indiqué dans la charte du MIT, le partage des connaissances et des savoirs-faire est un principe de base des fablabs : les usagers s'engagent à "contribuer à la documentation et à l'acquisition des connaissances".

Pourquoi documenter?


- Partager du savoir Dans l'esprit de la culture libre, et parce que vous avez certainement déjà profité de la documentation d'autres personnes, votre documentation permettra à d'autres usagers de refabriquer, améliorer ou adapter votre réalisation.

- Gagner du temps Documenter son projet et ses différentes étapes permet de se souvenir de ce que l'on a déjà fait et de ne pas refaire les mêmes erreurs.

- Avoir des retours Souvent au cours de l'élaboration d'un projet, on a besoin de l'aide d'autres usagers : une documentation détaillée leur permettra de bien le comprendre et donc de vous aider plus efficacement.

- Éviter de se blesser ou d'abîmer du matériel Une bonne documentation de l'utilisation des machines et des outils permet d'améliorer la sécurité dans les ateliers.

Que documenter ?

Sur ce wiki vous pouvez documenter vos travaux personnels ou collectifs (étapes, matériaux et machines utilisées, difficultés rencontrées, etc) mais aussi :

- contribuer aux [| pages d'utilisation des machines] (astuces, réglages, etc),

- partager des tutoriaux, des astuces techniques, des informations sur le fonctionnement de logiciels, sur le travail de certains matériaux,

- compléter les pages d'informations de la partie "À propos des fablabs".


De manière générale, n'hésitez pas à corriger ou améliorer le contenu déjà présent dans ce wiki.


Comment et quand documenter? Quelles informations mettre dans sa documentation ?

Avant : exposer son idée

Exposer son idée permet de se l'exprimer clairement à soi même, et facilite la communication du projet à d'autres personnes susceptibles de vous aider

Fiche-idée papier ou scannée ?

exemple from meuhlab:
Exemple-fiche idée.png

version vierge:
Fiche-idee.png

télécharger la fiche en svg,pdf et png

Pendant : faire un journal de bord

Pas à pas, documenter l'expérience avec les essais ou les problèmes rencontrés et leurs résolutions.

Le cahier de laboratoire ou journal de bord permet de se souvenir des étapes de recherches, de garder des traces pour soi-même et éventuellement d'autres personnes qui travailleront sur ce sujet.

À la fin : présenter le projet finalisé

Raffiner le travail du journal de bord pour le rendre lisible et pour valoriser le projet. En gras : les éléments indispensables à mettre dans une documentation

  • Titre du projet
  • Une belle image
  • Porteur du projet : lien vers page participants
  • Date
  • Licence : libre !
  • Contexte
  • Fichiers source principaux : liens
  • Inspiration, source du projet
  • Tags
  • Avancement (Concept, Développement, Beta, Fini)
  • Machines utilisées
  • Ingrédients(matériaux, composants...)
  • Fournisseurs, bons plans
  • Logiciels
  • Description (5 lignes, état de l'art, matériaux, galerie photos...)
  • Réalisation (=> conception)

//medias supports//


Bonnes Pratiques/ Références/Mise en page

Dépliant : faire, documenter, partager

Documentationfablab-depliant-recto.jpeg Documentationfablab-depliant-verso.jpeg

Ce dépliant tiré de cette page Media:DepliantVraimentLibre.svg

Il a été réalisé suite à une session de travail à Marseille en octobre 2014

Une nouvelle version est publiée ici : http://reso-nance.org/files/lfo/docfablab/ Version plus aboutie Fichier:Depliant.documentation.zip


Affiche Licence

Licences.jpg

Media:Licences.pdf
Media:Licences pfc.svg
Media:Typos.zip