User Documentation Quelques points à prendre en compte lors de la soumission d'un article à cette documentation :
- Images : éviter les captures d'écran au format jpg, floues et un peu trop petites. Les remplacer par des images png plus grandes. Faire en sorte que toutes les captures d'écran mesurent entre 1500 et 2500 pixels de large, sachant qu'elles donneront lieu à la création d'un ensemble d'images adaptatives dans différentes tailles et formats, y compris webp. Voir nos conseils pour de meilleures captures d'écran.
- Titres : utiliser des titres plutôt que des lignes en gras. Ces lignes en gras ne créent pas de structure sémantique de document et seraient signalées par le vérificateur d'accessibilité de Joomla. Les organiser selon une hiérarchie logique : ne pas passer de H2 à H4 en sautant H3. Ne pas utiliser de H1 dans les articles, car il ne doit y avoir qu'un seul H1 sur la page : le titre de l'article.
- Cliquer : n'utiliser ce terme que pour cliquer sur un bouton. Pas pour sélectionner un élément dans une liste d'options : dans ce cas, utiliser « Sélectionner ». À l'origine, le mot « Cliquer » est utilisé pour les actions de la souris et n'est pas approprié pour les utilisateurs de clavier ou de pavé tactile.
- Ponctuation : nous avons de nombreuses listes de termes qui commencent par un mot ou groupe de mots en gras suivi d'un deux-points ou d'un point, parfois à l'intérieur du groupe en gras et parfois à l'extérieur. Par souci de cohérence, ne pas mettre en gras le deux-points ou le point. Comme dans la liste que vous êtes en train de lire.
- Mots à surveiller : voir cette liste dans le manuel des développeurs. Par exemple, faire attention à back-end, front-end et directory, des mots qui figurent dans la colonne des mots inacceptables de la liste des mots à surveiller.
- Gestionnaire : ce terme était souvent utilisé dans Joomla 3, comme dans Gestionnaire d'articles, Gestionnaire de menus ou Gestionnaire d'utilisateurs. Il a pratiquement disparu de Joomla 4+. Utiliser désormais ce qui figure dans la barre de titre d'une page d'administration, par exemple la page de liste Articles, Menus : page de liste Liens ou la page de liste Modules (Site).
- Usage cohérent de dans ou sur : comme dans « Sélectionner le bouton Aide dans/sur la Barre d'outils » ou « dans/sur la Page ». On peut considérer ces emplacements comme des conteneurs, ce qui ferait de dans le mot à privilégier.