Aide:Documenter

Le bonnes pratiques pour documenter une activité dans le fablab

Pourquoi documenter?

les bonnes raisons

les motivations

à partir de quand documenter?

qu'est-ce qui vaut le coup?

"chaque petit chat est authentique"

Quand c'est utile à soit/ aux autres

Que documenter?

• un Projet
• une page ressource
  • sur une machine
  • sur un logiciel
  • sur un matériel
  • politique
  • culturelle
• un atelier pédagogique

Comment documenter? Quelles informations mettre dans sa documentation ?

*Titre du projet

• 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éiriaux, galerie photos...)

• Réalisation

à la fin, rafiner le travail pour le rendre lisible

//medias supports//

Bonnes Pratiques/ Références

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/