Aide:Documenter : Différence entre versions

De fablabo
Aller à : navigation, rechercher
(Bonnes Pratiques/ Références)
(Comment documenter?)
Ligne 27 : Ligne 27 :
  
  
==Comment documenter?==
+
==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
 +
*
  
//medias supports//
 
  
 
===exposer son idée===
 
===exposer son idée===
Ligne 38 : Ligne 54 :
  
 
===à la fin, rafiner le travail pour le rendre lisible===
 
===à la fin, rafiner le travail pour le rendre lisible===
 +
//medias supports//
  
 
==Bonnes Pratiques/ Références==
 
==Bonnes Pratiques/ Références==

Version du 18 septembre 2014 à 15:29

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


exposer son idée

faire un carnet de bord

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