Chapitre 10. Style

N'utilisez pas de formes contractées. Utilisez toujours les mots entiers. ``Don't use contractions'' n'est pas correct[1].

Ne pas contracter donne au texte un ton plus formel, est plus précis, et facilite la tâche des traducteurs.

Dans une énumération au sein d'un paragraphe, séparez avec des virgules les éléments les uns des autres. Mettez aussi un virgule et la conjonction ``et'' avant le dernier élément.

Examinez par exemple la phrase suivante :

C'est une liste d'un, deux et trois éléments.

Est-ce une liste de trois éléments, ``un'', ``deux'', et ``trois'', ou une liste de deux éléments, ``un'' et ``deux et trois'' ?

Il vaut mieux être explicite et ajouter la dernière virgule :

C'est une liste d'un, deux, et trois éléments.

Evitez les redondances. En particulier, ``la commande'', ``le fichier'', et ``man commande'' sont probablement redondants.

Voici deux exemples pour ce qui concerne les commandes. Il est préférable d'utiliser le second.

Voici deux exemples pour ce qui concerne les noms de fichiers. Il est préférable d'utiliser le second.

Voici enfin deux exemples pour les références aux pages de manuel. Il est préférable d'utiliser le second (il emploie <citerefentry>).