Conventions typographique

Capitalisation des titres

Il faut éviter la capitalisation du titre, comme A Very Fine Heading, et optez plutôt pour un titre très fin. Capitalisation gratuite ou casse de titre, montrent souvent un malentendu - ou un mépris pour - conventions orthographiques. Nous préférons ce que l’on appelle le “cas de peine”, avec un seul capital initial pour démarrer les en-têtes.

Longueur de la ligne

Lors de la modification de la source de la documentation, qui est écrit en HTML simple, limitez la longueur de vos lignes à environ 72 caractères.

Certains d’entre nous vont encore plus loin et utiliser ce qu’on appelle semantic linefeeds, qui est une technique par laquelle les lignes source HTML, qui ne sont pas lus par le public, sont divisés à des “ruptures naturelles” dans la prose. En d’autres termes, les phrases sont divisées aux pauses naturelles entre les clauses. Au lieu de s’embêter avec les lignes de chaque paragraphe de sorte qu’ils se terminent tous près de la marge droite, les sauts de ligne peuvent être ajoutés n’importe où qu’il y a une rupture entre les idées.

Cela peut rendre les différences très faciles à lire lors de la collaboration via git, mais ce n’est pas quelque chose que nous imposons aux contributeurs d’utiliser.