Règles de ponctuation dans les listes
Les éléments de listes ordonnées et non-ordonnées ne doivent pas se terminer par une marque de ponctuation, telle qu'une virgule, un point-virgule ou un point, sauf si tous les éléments d'une liste forment des phrases complètes. Cette approche optimise la réutilisation de contenu.
Les règles de ponctuation dans les listes ont toujours fait l'objet de controverses. Dans DITA, la réutilisation de contenu avec la publication conditionnelle facilite un peu les choses.
- Tous les éléments se terminent par une virgule, sauf le dernier qui se termine par un point.
- Tous les éléments se terminent par un point-virgule, sauf le dernier qui se termine par un point.
- Les éléments ne sont pas ponctués, sauf le dernier qui se termine par un point.
Dans DITA, le contenu est privé de contexte. Cela signifie qu'une liste rédigée sous DITA peut apparaître dans une autre séquence après la publication. Certains éléments peuvent être supprimés lors du processus de publication conditionnelle ; par exemple, les éléments qui s'adressent aux administrateurs peuvent être omis dans une version destinée à des utilisateurs novices.
Comme le dernier élément ne peut pas toujours être identifié, il est inutile d'ajouter un élément de ponctuation (ex. : un point) à cet élément. (En d'autres termes, le dernier élément ne fait pas exception à la règle.)
Les éléments de liste ne doivent donc pas se terminer par une marque de ponctuation, afin d'optimiser la réutilisation de contenu. Il existe une exception à cette directive : lorsque tous les éléments d'une liste sont des phrases complètes.
Dans d'autres cas, si cela est jugé nécessaire, un point peut être ajouté à la fin d'une liste grâce au processus de publication. Pour que cette méthode fonctionne, il est essentiel que toutes les listes, y compris celles comprenant des phrases complètes, soient dépourvues de ponctuation finale.