FR:Directives du wiki

From OpenStreetMap Wiki
(Redirected from FR:Wiki guidelines)
Jump to navigation Jump to search
À propos de ce wiki Directives Organisation Traduction Nettoyage Aide

Traduction de la source anglaise v.2018-09-08.

Les recommandations wiki suivantes doivent être appliquées afin de contribuer à créer un wiki utile et facilement utilisable par tous. La page WikiProject Cleanup est destinée à coordonner le travail sur le wiki entre autres pour le rendre plus conforme à ces recommandations.

Facilité de compréhension

Faites des pages courtes, avec un langage simple et en évitant les jargons. L'objectif d'OpenStreetMap est d'être accessible à tous, et la documentation doit refléter cet état d'esprit. Ce que vous écrivez doit pouvoir être lu par des enfants ou des personnes âgées !

Certaines pages du wiki prennent naturellement la forme de documentations techniques. Même dans ces pages, il faudrait garder à l'esprit que nous devons être compréhensibles par des utilisateurs de niveaux techniques variés. Écrivez des présentations simples pour expliquer un sujet donné, et n'hésitez pas à sortir les détails très complexes dans une page à part plus spécialisée.

Structure

Le wiki doit être fait de telle manière que les utilisateurs puissent trouver facilement à partir de la page d'accueil les informations qu'ils recherchent. Si certains liens de la page d'accueil pointent directement sur quelques sujets principaux, les autres correspondent à des pages de synthèse sur un sujet donné. Celles-ci constituent le niveau suivant d'une sorte de hiérarchie de navigation. Ce sont souvent des pages courtes avec beaucoup de liens et peu de texte (on les appelle aussi « portails »). Il faut faire en sorte que cette navigation soit fluide pour les nouveaux visiteurs.

Incohérences

Les incohérences sont un vrai problème. L'information sur les recommandations actuelles de marquage doit être cohérente. Si cela n'est pas le cas, s'il vous plaît « entrez en contact ! » avec d'autres utilisateurs pour développer un consensus. Idéalement les recommandations de marquage doivent correspondre aux pratiques de marquage actuelles, sauf s'il y a une raison valable de ne pas le faire.

Les propositions nouvelles ou de changement pour le marquage sont l'exception à cette règle. Elles doivent cependant être clairement identifiées comme des propositions.

Redondances

La répétition d'informations est souvent problématique parce qu'elle peut être source d'informations contradictoires et qu'elle augmente le travail à effectuer. Lorsqu'elle n'est pas justifiée, il faudrait faire en sorte de fusionner les informations en un unique endroit plus complet. Cela peut faire l'objet de discussions avec les autres utilisateurs ! On peut envisager de faire une synthèse du sujet dans une autre page, mais cette synthèse devra pointer vers l'article principal sur ce sujet.

Le modèle {{Merge}} sert à marquer les pages qui doivent être réorganisées afin de supprimer des doublons.

Lorsque la duplication d'informations est utile (par exemple, parce que les données sont présentées de manière différente, au niveau du style, de la structure de page ou du public auquel elles sont destinées), il est important de le justifier et de faire des liens réciproques entre les différents articles concernés. S'il n'y a pas de bonne raison à cette duplication, alors les contenus concernés devraient être agrégés. Notons toutefois qu'agréger ces articles ne veut pas forcément dire qu'il ne devra en rester qu'un là où il y en avait deux auparavant. Il y a d'autres possibilités, comme par exemple faire un premier article de synthèse non technique qui pointerait vers un deuxième article techniquement plus détaillé.

Titres - Convention de nommage des pages

Merci de respecter les conventions de nommage et d'usage des majuscules dans Wikipédia : « Lorsque les titres de pages sont en plusieurs mots, il conviendra de laisser en minuscules tous les mots après le premier, sauf si le titre est composé de noms propres qui ont toujours leur initiale en majuscule même au milieu d'une phrase ».

N'écrivez pas de titres dans lesquels les mots ont leur première lettre en majuscule et sont collés les uns aux autres (comme "TitreDePage" par exemple) - MediaWiki autorise l'utilisation d'espace de la même manière qu'en langage naturel. La seule exception à cela est lorsque le titre de la page correspond au nom de quelque chose qui s'écrit toujours avec les mots collés entre eux, comme par exemple « OpenLayers ».

Les préfixes ont beaucoup été utilisés dans les titres de page à une certaine époque (comme le préfixe « WikiProject », entre autres). C'est une pratique maintenant obsolète car assez lourde, mais il est difficile de rectifier tous les titres concernés maintement. Déplacer les pages en question serait une tâche très importante. En conséquence, il est fortement déconseillé de créer de nouveaux schémas de préfixes. Utilisez des titres en langage naturel, et pour structurer un ensemble de pages, mettez des liens réciproques dans le corps des pages elles-mêmes. Merci de consulter la page sur l'organisation du wiki pour avoir les explications les plus à jour sur le sujet.

Introduction

Les pages doivent commencer par un court paragraphe d'introduction comprenant quelques phrases. Celui-ci doit inclure le titre en gras et expliquer l'objet de la page. Il est souvent intéressant d'inclure un lien vers une page plus générale et d'autres plus spécifiques, cela facilite la navigation.

Cette section d'introduction devrait apparaître avant les autres rubriques (et avant la table des matières sur une longue page). Notez qu'il est souvent d'usage de créer un premier chapitre « Introduction ». Il faudrait réarranger cela pour qu'au moins une partie de ce chapitre soit en résumé en haut de la page au dessus toutes les rubriques. Cela permettra d'atteindre une mise en page uniforme dans tout le wiki.

Utilisation de liens

Les pages doivent être judicieusement liées pour faciliter les utilisateurs à trouver les informations qu'ils recherchent. Les sujets connexes importants sont généralement en lien dans l'introduction. Si vous n'arrivez pas décrire l'objet d'une page wiki liée à partir d'ici, c'est probablement que vous ne décrivez pas cette page en termes assez généraux. Vous êtes également encouragés à faire des liens vers les sujets connexes du reste de la page.

Lien d'une section vers une autre page

Le code {{Main|Nom de page}} pourra être utilisé dans un entête de section pour fournir un lien à une autre page en relation avec le sujet de la section. Cette section devrait alors seulement résumer la page liée (sans être en conflit avec celle ci). Le titre de la section devrait normalement être le même que celui de la page en lien.

Liens vers Wikipédia

Les liens vers Wikipédia peuvent être source de confusion. Ne faire un lien vers Wikipédia que si c'est utile, et si le concept n'est pas mieux expliqué pour le contexte OSM sur ce wiki.

Si vous utilisez la syntaxe [[wikipedia:Nom de page]], laissez le préfixe wikipedia: directement tel quel. Ne mettez pas de texte alternatif [[wikipedia:Nom de page|Nom de page]] car cela peut être mal interprété par un navigateur basique. Cependant, vous pouvez utiliser un modèle pour rendre le lien externe vers Wikipédia plus explicite : {{Wikipedia|en|Page name}}, ou {{Wikipedia|en|Page name|text= no }} pour simplement conservez l'icône d'en tête sans le texte complementaire "sur Wikipedia".

Page concernant un site web

Nous avons beaucoup de pages wiki consacrées à décrire certains sites Web externes (services de cartes, produits logiciels, etc.). Évidemment, les liens externes vers ces sites sont extrêmement importants. Le lien majeur doit être placé entre parenthèses après le titre (en gras) dans la première phrase et/ou lié à sa propre adresse en toutes lettres dans les premières phrases descriptives.

Sur ces pages, il est inutile de recopier beaucoup d'informations sur le site externe. La page doit décrire le site dans le contexte OSM. Restez neutre et non promotionnel dans votre description, bien qu'elle vise à utiliser un langage encouragé par OSM ou les usages d'OSM.

Liste de logiciels / services

De nombreuses pages contiennent des listes à puces ou en tableaux de logiciels / services. Lorsqu'il existe des pages wiki sur ces logiciels et même s'il n'y en a pas (liens rouges), le format à privilégier est un lien interne vers la page wiki OSM suivi d'un lien externe vers le service entre parenthèses. Cela peut être suivi d'une courte description ou d'autres colonnes de tableau. Il faudrait viser à créer des liens vers la page de wiki et un lien externe, même si la page de wiki n'existe pas encore, pour encourager une interconnexion harmonieuse du wiki. Les liens rouges peuvent être renseignés avec une information abrégée suivant les conseils ci-dessous.

Le lien externe vers une URL complète est plus agréable lorsqu'elle est courte, car l'utilisateur sait à quoi s'attendre quand il clique dessus. Un texte alternatif peut être utilisé pour raccourcir l'intitulé si besoin, en gardant de préférence le nom du domaine pour qu'il soit bien clair qu'il s'agit d'un lien externe.

Exemple :

Lorsque l'espace est limité (souvent dans le cas des tableaux wiki) il est possible d'utiliser la syntaxe de lien numéroté (exemple [1]) qui n'affiche le lien qu'en bas de fenêtre. On peut aussi ne pas mettre le lien externe et lier uniquement la page wiki, si celle-ci contient elle-même le lien externe. Si la page wiki n'existe pas, on peut aussi choisir de ne fournir qu'un lien externe, mais il est préférable de créer une page wiki avec une description réduite.

Catégories

Les catégories doivent être utilisées pour regrouper des pages par type et doivent suivre les mêmes conventions de dénomination que pour les pages wiki.

Les catégories peuvent elles-mêmes être catégorisées pour créer une hiérarchie facilitant la navigation sur un sujet d'intérêt. Par exemple la Category:Buses est classée dans Category:Public transport.

Les pages peuvent être classées dans plusieurs catégories, mais ne doivent pas « spammer » les catégories. Une page relative aux autobus (par exemple, une page sur les arrêts de bus) devrait être classée dans [[:Category:Buses]] mais pas dans [[:Category:Public transport]]. Cependant, la page principale buses doit être étiquetée dans la catégorie « Public transport », et dans celle qui lui est spécifique.

Une simple ligne d'introduction devrait être mise dans chaque « page catégorie » en général pour faire le lien vers la « page principale » sur le sujet, idéalement du même nom. Par exemple, * Pages relatives aux [[Public transport]]. serait une introduction à la catégorie « Public transport ».

Lorsqu'elles sont catégorisées, les pages doivent utiliser l'option de tri pour s'assurer si nécessaire qu'elles apparaissent correctement dans la liste des pages. Par exemple regardez les pages répertoriées dans Category:Users in London. Elles auraient pu être répertoriées sous 'U' en raison du préfixe 'User:', mais cela a été changé. Par exemple, User:Harry Wood a été catégorisé dans le wiki avec la codification [[Category:Users in London|Harry Wood]] triable sur la phrase mentionnée après le '|'.

Langue

OpenStreetMap utilise l'« anglais britannique » pour les pages générales en anglais et l'« anglais local » approprié pour les pages locales sur un sujet. De même, toute page concernant essentiellement les États-Unis, pour quelque raison que ce soit, utilisera l'« anglais américain ». Cela vaut particulièrement pour les pages situées dans Mapping projects.

Traduction

Voir Traduction du wiki. Cela fourni quelques réflexions philosophiques préalables sur ce que nous cherchons à obtenir par les traductions du wiki, alors qu'on ne sait pas si le wiki migrera via l'extention Translate.

Formatage des dates

Les dates doivent être formatées de l'une des façons suivantes selon la précision requise :

  • 1 août 2009 (le format normal, à moins qu'il y ait incertitude ou que le jour soit prépondérant ; pas besoin du zéro dans la valeur du jour)
  • Mercredi 1 août 2009 (lorsque le jour de la semaine est important)
  • Août 2009 (jour du mois non connu ni pertinent)
  • 2009-08-01 (format fixe issu de la norme ISO 8601, à utiliser dans les données tabulaires, en particulier lorsque le contenu doit être inclus dans plusieurs pages traduites ; inclut zéro-de-remplissage à gauche)
  • 2009-08 (similaire lorsque le jour du mois n'est ni connu ni pertinent)
  • 2009 (année seulement, sans séparateur de milliers)
  • 'Prochainement' (Août 2009) (si une prévision a été affichée à un moment donné)

Les suffixes ordinaux (er, ère, ième) ne sont pas nécessaires, et les jours et mois devraient être écrits en entier. Évitez les dates incomplètes peu claires, et l'utilisation des saisons (l'été dans l'hémisphère nord est l'hiver dans le sud !).

Résumé des modifications

N'oubliez pas d'utiliser le champ "Résumé" lors de l'édition pour indiquer les modifications. Cela aide les autres éditeurs.