Aide:Documenter : Différence entre versions

De fablabo
Aller à : navigation, rechercher
(Pourquoi documenter?)
(Liens Projets/présentations)
Ligne 98 : Ligne 98 :
  
 
===Liens Projets/présentations===
 
===Liens Projets/présentations===
 
Mediamatic<br />
 
http://www.mediamatic.net/search/251345/en<br />
 
Open Processing<br />
 
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 du 29 septembre 2014 à 15:12

Le bonnes pratiques pour documenter une activité dans le fablab

Pourquoi documenter?

les bonnes raisons et motivations :

  • pour ne pas oublier après mes vacances
  • cette information manquai
  • pour gagner du temps
  • pour partager les bons plans
  • pour éviter de casser du matos
  • pour éviter de se blesser
  • pour optimiser son projet
  • inviter aux réutilisations
  • avoir des retours et des avis d'autres gens
  • parc'que j'ai profité de la documentation d'autres personnes
  • pour ne pas refaire les mêmes erreurs
  • Rendre les choses plus accessibles
  • pour pouvoir refaire comme un carnet de bord
  • pour partager du savoir

à partir de quand documenter?

qu'est-ce qui vaut le coup?

"chaque petit chat est authentique" : même le travail le plus simple peut être intéressant à documenter, ne serai-ce que pour apprendre à bien documenter

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

Exposer son idée permet de se l'exprimer clairement à soit 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, 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

Licences.jpg

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

Liens Projets/présentations