Documenter son projet : Différence entre versions

Ligne 4 : Ligne 4 :
 
|Description=<translate>Cette page propose différents supports dans l'optique d'accompagner les makers dans la documentation et réalisation de leurs projets.
 
|Description=<translate>Cette page propose différents supports dans l'optique d'accompagner les makers dans la documentation et réalisation de leurs projets.
  
Ce projet est né d'une collaboration entre l'Edulab de l'Université Rennes 2 et les étudiants du CFTTR (Centre de Formation des Traducteurs-localisateurs, Terminologues et Rédacteurs techniques) dans le cadre du Hackathon POCL (Petit Object Connecté Ludique)</translate>
+
Ce projet est né d'une collaboration entre l'Edulab de l'Université Rennes 2 et les étudiants du CFTTR (Centre de Formation des Traducteurs-localisateurs, Terminologues et Rédacteurs techniques) dans le cadre du Hackathon POCL (Petit Object Connecté Ludique).</translate>
 
|Area=Machines and Tools
 
|Area=Machines and Tools
 
|Type=Rédaction
 
|Type=Rédaction

Version du 28 février 2022 à 17:14

Auteur avatarCFTTR | Dernière modification 16/03/2022 par CFTTR

Cette page propose différents supports dans l'optique d'accompagner les makers dans la documentation et réalisation de leurs projets. Ce projet est né d'une collaboration entre l'Edulab de l'Université Rennes 2 et les étudiants du CFTTR (Centre de Formation des Traducteurs-localisateurs, Terminologues et Rédacteurs techniques) dans le cadre du Hackathon POCL (Petit Object Connecté Ludique).
Difficulté
Moyen
Durée
0 heure(s)
Catégories
Machines & Outils
Coût
0 EUR (€)

Étape 1 - Modèle de document

Ces images sont une ébauche de la documentation d'un projet créée à partir du modèle.

Inspiré des pages Wiki, ce modèle reprend tous les éléments dont vous avez besoin pour créer votre propre page de projet.

Retrouvez le modèle en version française et anglaise dans les Fichiers.


Étape 2 - Poster

Ce poster décrit les différentes étapes de documentation et propose quelques règles de rédaction.

Étapes

  1. Choisir un titre et décrire le projet
  2. Énumérer la liste des outils et matériels
  3. Relever toutes les étapes du projet
  4. Rédiger
  5. Définir les caractéristiques du projet (durée, difficulté, coût, etc.)


Règles de rédaction


  1. Prendre des notes tout au long du montage
  2. Numéroter les étapes par ordre chronologique
  3. Éviter l'utilisation de jargon
  4. Commencer chaque étape par l'impératif
  5. Homogénéiser la formulation des phrases
  6. Être clair et concis




Étape 3 - Check-list

Cette check-list vous accompagne dans la rédaction. Une fois une étape achevée, il ne vous reste plus qu'à cocher la case correspondante.


Prenez des photos de toutes les étapes de montage.
Ne regroupez pas toutes les idées en une seule étape. Un surplus d'information empêche la mise en valeur des étapes importantes.




Étape 4 - Guide de style

Ce manuel décrit plus en détails les règles de rédaction à appliquer dans la documentation de votre projet.

Une étape = une action
Privilégier la voix active
Indiquer le résultat de l'action



Commentaires

Published