Outils d'utilisateurs

Outils du Site


aide:documenter

Ceci est une ancienne révision du document !


Documenter son projet

Le FabLab est un atelier contributif et l'accès est gratuit, mais en échange :

  • Vous vous engagez à participer aux autres projets en cours au moment où vous vous trouvez sur place. Vous faites bénéficier les autres de vos savoirs, et les autres vous font bénéficier de leurs savoirs.
  • Vous vous engagez à documenter ce que vous réalisez : à savoir, écrire la “recette de cuisine” de votre objet pour que d’autres puissent le refaire. Notez que cela ne vous empêche pas d'en faire une exploitation commerciale, en choisissant une licence adaptée.
  • Vous vous engagez à partager cette documentation, en la publiant sur notre wiki. Ce partage peut se faire sous une licence qui interdit l’exploitation commerciale de votre projet, mais qui en autorise la reproduction à titre personnel, comme par exemple une licence Creative Commons.

Documenter son projet c'est réaliser une page dédiée a votre réalisation dans la rubrique Les réalisations du FabLab, avec la descriptions des différentes étapes du projet, les difficulté rencontrées etc. … Mais c'est aussi :

  • Documenter l'utilisation des machines dans la rubrique dédiée (procédure, astuces, réglages, …)
  • Documenter les logiciels utilisés (tutoriaux, astuces, plugins utiles, …)
  • Indiquer dans la rubrique Les ressources/Fournisseurs de matériaux où vous vous être procurés vos matériaux et les potentiels bon plans ou remarques vous vous auriez à partager.
  • Ajouter des liens vers les ressources qui vous ont été utiles durant votre projet dans la rubrique Ressources
  • Rédiger de petits articles sur tel ou tel sujet que vous auriez appris ou approfondi lors votre réalisation, et qui pourraient être utiles pour d'autre projets

Votre documentation permettra ainsi a d'autres usager de fablabs de refabriquer, d’améliorer ou d'adapter votre réalisation, mais aussi de partager les connaissances que vous aurez acquise lors de votre projet avec les autres utilisateurs.

N'hésitez pas non plus à corriger ou améliorer le contenu déjà présent dans ce wiki.

Comment créer une page pour mon projet

Pour commencer, créez une page pour votre projet : créer une page sur Dokuwiki. Vous pouvez aussi utiliser le formulaire présent en haut de la rubrique Les réalisations du FabLab pour créer votre page.

Remarque sur la syntaxe dokuwiki : Essayez d'utiliser les niveau de titres (boutons H dans la barre d'outils) en commençant avec un titre de niveau 1 (H1) comme titre de page. Les fonctions gras, italique, souligné sont à éviter pour les titres et sous-titres.

Voici quelques ligne directrices pour documenter au mieux vos réalisations, qu'elles soient en cours de fabrication, ou terminées.

N'utilisez que des contenus dont la diffusion est autorisée (généralement sous licence libre).

  • Nom du projet
  • Descriptif du projet
    • contexte
    • objectif, expérience utilisateur
    • licence
  • Équipement nécessaires à la réalisation
    • machines (liens vers les fiches machines du wiki)
    • outils
    • matériaux
    • logiciels (liens vers les fiches logiciels du wiki)
  • Étapes de réalisation
  • Difficultés rencontrées et solutions mises en place ou envisagées
  • Suite du projet

N'oubliez pas d'indiquer vos sources (en note de bas de page, par exemple).

Si aucune fiche de wiki ne correspond au logiciel ou à la machine que vous avez utilisé, c'est l'occasion d'en créer une. Vous pouvez aussi renvoyer vers un autre site.

Pour télécharger un fichier, utilisez le gestionnaire de médias (ouvrez-le dans un nouvel onglet).

Pour connaître la syntaxe particulière de DokuWiki (le logiciel utilisé pour ce site), consultez la syntaxe de mise en page.

aide/documenter.1399465046.txt.gz · Dernière modification: 2014/05/07 14:17 par bumblebee