Aide:Documenter : Différence entre versions

Version du 19 septembre 2014 à 14:23

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 et quand documenter? Quelles informations mettre dans sa documentation ?

Avant : exposer son idée

Fiche-idée papier ou scannée ?

exemple from meuhlab:

version vierge:

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

Pendant : faire un journal de bord

Pas à pas, l'expérience avec les essais erreurs.

A 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

Affiche Licence

[fichier pdf]
Media:Licences pfc.svg fichier svg

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/