mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-23 18:17:20 +00:00
18 lines
2.1 KiB
Plaintext
18 lines
2.1 KiB
Plaintext
created: 20150110182900000
|
|
fr-title: Style technique rédactionnel
|
|
modified: 20150621210510651
|
|
tags: [[Improving TiddlyWiki Documentation]]
|
|
title: Technical Prose Style
|
|
type: text/vnd.tiddlywiki
|
|
|
|
Lors de la rédaction d'un [[tiddler d'apprentissage|Instruction Tiddlers]], commencez par planifier la route des informations que vous souhaitez présenter. Ce doit être un cheminement simple, logique, progressif, sans retour en arrière ou référence à suivre.
|
|
|
|
Employez cette méthode, même lors d'expressions indépendantes<<:>> toujours aller de la cause à l'effet, de l'ancien ou connu vers le nouveau ou l'inconnu. Une phrase technique claire contient rarement plus d'une idée. Elle évite donc les informations entre parenthèses. De même, garder une structure de paragraphe simple. Une présentation linéaire est souvent plus facile à comprendre que si elle est hiérarchisée.
|
|
|
|
Il est souvent possible de simplifier une phrase sans changer sa signification, simplement en ajustant son vocabulaire ou sa structure grammaticale. <<.word "le processus de la macro est exécutée">> signifie simplement <<.word "La macro s'exécute">>. <<.word "Votre attente pourrait être ...">> signifie simplement <<.word "Vous pourriez attendre ...">>.
|
|
|
|
Préférez la voix active par défaut<<:>> <<.word "Jane créé un tiddler">> plutôt que <<.word "un tiddler est créé par Jane">>. La voix passive peut être utile si vous voulez focaliser l'attention du lecteur sur l'action elle-même ou sur son résultat<<:>> <<.word "un tiddler est créé">>. Mais il est souvent plus clair d'aller de la cause à l'effet et dire en voix active, <<.word "Cela créé un tiddler">>.
|
|
|
|
La documentation présente souvent deux éléments en parallèle par similarité ou par différence. Le lecteur pourra plus facilement appréhender des concepts si vous employez la même structure de phrase pour chacun. Mais c'est contrebalancé par la nécessité de rompre la monotonie.
|
|
|
|
Préférez les instructions précises aux discours verbeux. Si quelque chose a un nom, l'utiliser. Si quelque chose n'a pas de nom, lui attribuer un tiddler. |