Documenter son projet : Différence entre versions

Ligne 34 : Ligne 34 :
 
{{Tuto Step
 
{{Tuto Step
 
|Step_Title=<translate>Modèle de document</translate>
 
|Step_Title=<translate>Modèle de document</translate>
|Step_Content=<translate>Ces images sont une ébauche de la documentation d'un projet créée à partir du modèle.  
+
|Step_Content=<translate>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'''.</translate>
+
{{Info|Retrouvez le modèle en version française et anglaise dans les Fichiers.}}</translate>
 
|Step_Picture_00=Documenter_son_projet_mod_le_1.PNG
 
|Step_Picture_00=Documenter_son_projet_mod_le_1.PNG
 
|Step_Picture_01=Documenter_son_projet_mod_le_2.PNG
 
|Step_Picture_01=Documenter_son_projet_mod_le_2.PNG
Ligne 44 : Ligne 45 :
 
{{Tuto Step
 
{{Tuto Step
 
|Step_Title=<translate>Poster</translate>
 
|Step_Title=<translate>Poster</translate>
|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.
  
<br /></translate>
+
==== '''Étapes''' ====
 +
 
 +
# Choisir un titre et décrire le projet
 +
# Énumérer la liste des outils et matériels
 +
# Relever toutes les étapes du projet
 +
# Rédiger
 +
# Définir les caractéristiques du projet (durée, difficulté, coût, etc.)
 +
 
 +
<br />
 +
 
 +
==== '''Règles de rédaction''' ====
 +
<br />
 +
 
 +
# Prendre des notes tout au long du montage
 +
# Numéroter les étapes par ordre chronologique
 +
# Éviter l'utilisation de jargon
 +
# Commencer chaque étape par l'impératif
 +
# Homogénéiser la formulation des phrases
 +
# Ê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
 
}}
 
}}
 
{{Tuto Step
 
{{Tuto Step
 
|Step_Title=<translate>Check-list</translate>
 
|Step_Title=<translate>Check-list</translate>
|Step_Content=<translate>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.</translate>
+
|Step_Content=<translate>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.
 +
 
 +
<br />{{Idea|Prenez des photos de toutes les étapes de montage.}}{{Dont|Ne regroupez pas toutes les idées en une seule étape. Un surplus d'information empêche la mise en valeur des étapes importantes.}}</translate>
 
|Step_Picture_00=Documenter_son_projet_Checklist_illustration.png
 
|Step_Picture_00=Documenter_son_projet_Checklist_illustration.png
 
}}
 
}}
 
{{Tuto Step
 
{{Tuto Step
 
|Step_Title=<translate>Guide de style</translate>
 
|Step_Title=<translate>Guide de style</translate>
|Step_Content=<translate>Ce manuel décrit plus en détails les règles de rédaction à appliquer dans la documentation de votre projet.</translate>
+
|Step_Content=<translate>Ce manuel décrit plus en détails les règles de rédaction à appliquer dans la documentation de votre projet.
 +
 
 +
{{Pin|1=Une étape = une action}}</translate>
 
|Step_Picture_00=Documenter_son_projet_Guide_de_style_1.png
 
|Step_Picture_00=Documenter_son_projet_Guide_de_style_1.png
 
|Step_Picture_01=Documenter_son_projet_Guide_de_style_2.png
 
|Step_Picture_01=Documenter_son_projet_Guide_de_style_2.png

Version du 25 février 2022 à 12:33

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 le 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



Commentaires

Draft