Documenter son projet : Différence entre versions

 
(Une révision intermédiaire par le même utilisateur non affichée)
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
Ligne 47 : Ligne 47 :
 
|Step_Content=<translate>Ce poster décrit les différentes étapes de documentation et propose quelques règles de rédaction.   
 
|Step_Content=<translate>Ce poster décrit les différentes étapes de documentation et propose quelques règles de rédaction.   
  
==== '''Étapes''' ====  
+
===='''Étapes'''====  
  
# Choisir un titre et décrire le projet
+
#Choisir un titre et décrire le projet
# Énumérer la liste des outils et matériels
+
#Énumérer la liste des outils et matériels
# Relever toutes les étapes du projet  
+
#Relever toutes les étapes du projet
# Rédiger  
+
#Rédiger
# Définir les caractéristiques du projet (durée, difficulté, coût, etc.)
+
#Définir les caractéristiques du projet (durée, difficulté, coût, etc.)
  
 
<br />
 
<br />
  
==== '''Règles de rédaction''' ====
+
===='''Règles de rédaction'''====
<br />
 
  
# Prendre des notes tout au long du montage
+
#Prendre des notes tout au long du montage
# Numéroter les étapes par ordre chronologique
+
#Numéroter les étapes par ordre chronologique
# Éviter l'utilisation de jargon  
+
#Éviter l'utilisation de jargon
# Commencer chaque étape par l'impératif
+
#Commencer chaque étape par l'impératif
# Homogénéiser la formulation des phrases
+
#Homogénéiser la formulation des phrases
# Être clair et concis</translate>
+
#Être clair et concis</translate>
 
|Step_Picture_00=Documenter_son_projet_Poster_redaction_illustration.png
 
|Step_Picture_00=Documenter_son_projet_Poster_redaction_illustration.png
 
}}
 
}}

Version actuelle datée du 16 mars 2022 à 18:42

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