Gestion:Politiques/Conventions

De Wikimedica
Les conventions énoncées sur cette page sont toujours sujettes à amélioration. Si vous désirez proposer un changement, éviter de modifier cette page et suggérez-le dans la Discussion afin qu'il puisse faire l'objet d'un consensus.

Les conventions de style utilisées sur Wikimedica ont pour but d'assurer l'uniformité du contenu et ainsi d'en faciliter la compréhension par tous. Ces conventions ont largement été empruntées de Wikipédia.

Elle pourront parfois paraître un peu fastidieuses, mais elles visent à optimiser la qualité du contenu de Wikimedica et assurer la pérennité du projet à long terme. Voici quelques raisons ayant motivé leur création :

  1. uniformiser la présentation du contenu ;
  2. faciliter la recherche de contenu par les utilisateurs et son indexation par les moteurs de recherche ;
  3. rendre le contenu accessible à des non initiés ;
  4. permettre à un lecteur d'entamer la lecture d'une page à partir de n'importe quelle section et ce faisant, rendre l'inclusion de parties de pages comme sections dans d'autres pages ;
  5. structurer l'information pour qu'elle puisse être traitée par des algorithmes.

Office québécois de la langue française

Si vous avez un doute sur la manière d'écrire un mot ou sur la manière de présenter l'information, référez-vous à la banque de dépannage linguistique de l'Office québécois de la langue française (OQLF).

Texte

Contenu

Préférablement, le texte dans les pages de Wikimedica doit être sous forme de prose et non de liste ou de succession d'énoncés reliés par des symboles. Cette manière de faire rend l'information opaque pour les non initiés et pire, elle empêche sa réutilisation dans d'autre page et son indexation par les moteurs de recherche. De plus, l'utilisation du texte gras, italique et souligné à outrance devrait être évitée.

À éviter :

Diabète → db type 1 ou 2 → glycémie élevée chroniquement → atteinte de la microvascularisationdommage aux organes cibles

  • coeur → MCAS
  • reins → néphro db
  • oeil → rétinopathie

Préférable :

Le diabète de type 1 ou 2 entraîne une élévation chronique des glycémies, ce qui a pour conséquence à long terme de causer une atteinte microvasculaire. Cette atteinte peut toucher de nombreux organes et entraîner certaines complications qui leur sont propres :

  • la maladie coronarienne athérosclérotique (coeur) ;
  • la néphropathie diabétique (rein) ;
  • la rétinopathie diabétique (oeil).
Wikimedica n'est pas un annuaire de liens web
Une page sur un sujet doit contenir toute l'information nécessaire à la compréhension de ce dernier. Les liens vers des ressources externes sont ajoutées comme références en support au texte et la lecture des références/liens externes, quoique potentiellement souhaitable pour approfondir un sujet, ne doit pas être essentielle.

Listes

Les listes sont encouragées, sauf lorsqu'elle viennent en remplacement de la prose. Une liste devrait idéalement être mise en contexte par une courte phrase la précédent. En ce qui a trait à l'usage du point virgule, il est recommendé pour diviser chacun des items. La minuscule est recommandée pour au début de chaque item de la liste jusqu'à l'usage du point à la fin de la phrase.

Exemple

Ceci est une phrase introductive :

  • item 1 ;
  • item 2 ;
  • item 3.

Exemple

Ceci est une phrase introductive :

  • item 1 : sous-item 1, sous-item 2, sous-item 3 ;
  • item 2 : sous-item 1, sous-item 2, sous-item 3 ;
  • item 3.

Symboles

L'utilisation des symboles est encouragée sauf lorsqu'ils viennent en remplacement du texte.

  • Admis : Streptocoque β-hémolytique du groupe A, β-bloqueur.
  • À proscrire :
    • « ¢ » au lieu de « cellule » ;
    • « diabète → complications » au lieu de « le diabète entraîne des complications ».

Abréviations et acronymes

Les abréviations et les acronymes, dans le domaine de la santé, sont choses courantes et largement utilisés afin de simplifier la lecture de texte. Or, ils sont souvent opaques pour les non initiés, empêchent une lecture du texte hors contexte, difficilement indexables par les moteurs de recherche et trop peu souvent adéquatement définis dans les textes qui les utilisent. La première fois qu'une abréviation ou qu'un acronyme est utilisé dans une section, il doit être défini au long. Pour le reste de la section, l'abréviation ou l'acronyne peut être utilisé. Par exemple :

SECTION 1

L'hypertension artérielle (HTA) est une maladie très fréquente en occident et touchera de nombreux adultes au cours de leur vie.
Les hommes sont généralement plus touchés par l'HTA que les femmes.

...

Le traitement de la HTA débute par l'amélioration des habitudes de vie.

SECTION 2

Si l'amélioration des habitudes de vie ne permet pas un contrôle de l'hypertension artérielle (HTA), il faudra songer à ajouter un traitement médicamenteux. La base de ce traitement sont les inhibiteurs de l'enzyme de conversion de l'angiotensine (IECA).

...

Les IECA, dans de nombreuses études, ont donnés de très bons résultats dans le contrôle de l'HTA.

Liens

L'ajout de liens est encouragé, et ce, même s'ils dirigent vers une page qui n'existe pas encore (elle sera probablement créée par un autre utilisateur). De manière à ne pas surcharger la page de liens, il est préférable de s'en tenir à un lien par item par section.

À éviter:

La maladie de Parkinson est une atteinte neurologique onsectetur adipiscing elit. Morbi in nulla ultricies, Maladie de Parkinson varius elit ac, feugiat velit. Ut urna lorem, viverra vel velit in, facilisis malesuada purus. Ut Maladie de Parkinson a condimentum massa. Aenean Maladie de Parkinson iaculis gravida augue in commodo. Aenean a velit fringilla, faucibus felis sit amet, suscipit orci. Maladie de Parkinson curabitur tempus tempor dolor a semper. Pellentesque tempor augue quis magna consequat viverra. Cras vitae venenatis ipsum. Vivamus Maladie de Parkinson et posuere ante, elementum euismod erat. Cras vel turpis placerat, interdum tellus vel, molestie eros. Aliquam Maladie de Parkinson at viverra quam.

Préférable:

La maladie de Parkinson est une atteinte neurologique onsectetur adipiscing elit. Morbi in nulla ultricies, Maladie de Parkinson varius elit ac, feugiat velit. Ut urna lorem, viverra vel velit in, facilisis malesuada purus. Ut Maladie de Parkinson a condimentum massa. Aenean Maladie de Parkinson iaculis gravida augue in commodo. Aenean a velit fringilla, faucibus felis sit amet, suscipit orci. Maladie de Parkinson curabitur tempus tempor dolor a semper. Pellentesque tempor augue quis magna consequat viverra. Cras vitae venenatis ipsum. Vivamus Maladie de Parkinson et posuere ante, elementum euismod erat. Cras vel turpis placerat, interdum tellus vel, molestie eros. Aliquam Maladie de Parkinson at viverra quam.

... (nouvelle section)

Aenean iaculis gravida augue in commodo. Aenean a velit fringilla, faucibus felis sit amet, suscipit orci. Maladie de Parkinson curabitur tempus tempor dolor a semper. Pellentesque tempor augue quis magna consequat viverra. Cras vitae venenatis ipsum. Vivamus Maladie de Parkinson et posuere ante, elementum euismod erat. Cras vel turpis placerat, interdum tellus vel, molestie eros. Aliquam Maladie de Parkinson at viverra quam.

Utilisation des médias

Diagramme du coeur

Avant d'ajouter tout média, il est important d'effectuer une recherche afin de s'assurer qu'un média similaire n'existe pas déjà sur la plateforme. Pour des conseils concernant le choix de médias, consultez le guide d'importation de fichiers.

Les médias ajoutés dans les pages doivent préférablement :

  1. être inclus en tant que vignette à droite du texte ;
  2. avoir une légende, à moins que le contenu soit très explicite ;
  3. respecter les règles de droits d'auteurs de Wikimedica ;
  4. ne pas être associés à un titre de figure (ex. voir figure 2), car ces derniers sont voués à périmer lorsque d'autres images sont ajoutées ;
  5. ne pas inclure de source dans la légende, car elle est déjà mentionnée sur la page du fichier ;
  6. ne pas inclure de mentions telle que « cliquez pour agrandir » dans la légende.

Autrement, ils doivent autant que possible suivre les principes suivants:

L'utilisation d'images de ce genre est à éviter.

Pertinence

  • Le média doit ajouter de l'information au contenu de la page ou en augmenter sa pertinence.
  • À moins d'exceptions, le média ne sert pas seulement de décoration. L'utilisation d'images « stock » est interdite.

Nom

  1. Ne nommez pas les fichiers avec des noms génériques ne permettant pas de les identifier:
    • IMG_4565.jpg
    • Capture d'écran 2018-05-12 15h51.png
    • Pneumonie (1).jpg, Pneumonie (2).jpg. etc.
  2. Nommez les fichiers de manière la plus descriptive possible sans utiliser d'articles et débuter par une majuscule. N'utilisez pas d'abréviations dans les images. Rappelez-vous qu'il doit être possible de rechercher des médias textuellement.
    «Un diagramme de coeur» ou «coeur» ou «dg coeur» devraient être «Coeur (diagramme)»
    «Rx AP pneumonie» devrait être «Pneumonie de la base droite (radiographie antéro-postérieure)»
  3. Commencez toujours le nom de l'image par le sujet et ensuite mettez les modalités ou d'autre détails entre parenthèse en dernier. De cette manière, les images pourront facilement être trouvées par thème.
    «Radiographie de poumons normaux» devrait être «Poumons normaux (radiographie)»
    «TDM de poumons normaux» devrait être «Poumons normaux (tomodensitométrie)»

Qualité

Éviter d'importer des tableaux sous forme d'images, préférer les recréer textuellement.
  1. Être de la meilleure qualité possible, c'est à dire de haute résolution, correctement exposée, etc.
  2. Ne pas contenir de description, titres, numéros de figures, noms dans l'image.
    Par exemple, une image de graphique avec une entête disant «Graphique de la saturation selon le temps».
    Pour les graphiques, il est toutefois pertinent que les axes soient légendés.
  3. Éviter autant que possible l'importation de captures d'écrans de texte (ex: tableaux), car ces derniers ne peuvent pas être recherchés par le moteur de recherche et sont difficiles à mettre à jour.

Description et conditions d'utilisation

Pour plus de détails sur la procédure de téléversement: Aide:Importation_de_fichiers#Télécharger_le_fichier
  1. Le modèle de description du media doit être rempli; celui-ci est automatiquement ajouté lorsque le fichier est téléversé par Spécial:Téléverser ou l'éditeur visuel.
  2. Une catégorie de droits d'auteurs doit être ajoutée aux média.

Organisation des pages à l'intérieur du wiki

Pour de plus amples explications, voir Aide:Structure

L'organisation des pages réfère à la manière dont les différentes pages sont mémorisées sur le wiki et accédées par un URL ou des liens. Elle diffère de l'organisation du contenu discuté dans une autre section. Les pages sont divisées en espace de nom : tout ce qui est utile pour les professionnels de la santé en pratique est dans l'espace de nom principal ; tous les projets et les contenus universitaires sont dans des espaces de nom différentes.

Si vous regardez l'adresse URL d'une page, vous aurez une bonne idée de l'espace de nom dans lequel se trouve la page que vous consultez.

Exemple

  • wikimedi.ca / wiki / Accueil
    • La page d'accueil est dans l'espace principal.
  • wikimedi.ca / wiki / Wikimedica : Conventions
    • La page de convention est une page de l'espace de nom Wikimedica (OBNL). Il s'agit d'une page de politique.
  • wikimedi.ca / wiki / ULaval : MED-1202 / MPOC
    • La page contient du contenu d'étude sur la MPOC du cours MED-1202 à l'Université Laval. L'espace de nom est « ULaval » et se consacre au contenu de cours qui est propre à l'institution. De la même manière, il existe l'espace de nom « UQTR », « UdeM », « UdeS » et « UMcGill ». Le contenu propre à l'institution doit rester dans l'espace de nom réservé à cette université.
  • wikimedi.ca / wiki / Maladie_de_Parkinson
    • Cette page est dans l'espace de nom principal. Il s'agit de la page sur la maladie du Parkinson destinée à l'ensemble des professionnels de la santé.
Dans le doute, il est toujours préférable de mettre la page que vous désirez créer dans l'espace de nom principal.

Les espaces de noms autre que l'espace principal comme (Wikimedica:, MediaWiki:, Modèles:, Catégorie:, Image:, etc.) sont réservés à des pages systèmes ou des pages d'administration. Tout ce qui concerne les professionnels de la santé en pratique doit se retrouver dans l'espace de nom principal.

Cours universitaires

Un cours permet l'organisation de pages en différents chapitres et associe à ces derniers des notes, des flashcards (quiz), des cas cliniques, etc. Une page de cours est nommée selon le code du cours. Son organisation par le professeur reste à son libre choix, mais l'organisation sur Wikimedica doit favoriser une approche systématique et pédagogique. Pour le cours MED-1208, si le professeur a abordé la protéinurie, l'hématurie et la filtration glomérulaire dans le même cours, voici ce à quoi la division pourrait ressembler.

Structure des pages

Introduction

  • L'introduction sur Wikimedica doit définir le concept énoncé dans le titre de la page.
    • Si le titre de la page est « Pomme », une introduction adéquate pourrait ressembler à ceci. « La pomme est un fruit comestible produite par les pommiers.[1] »
  • Ne dupliquez pas l'information : si vous présentez une information dans une autre section, ne la répétez pas dans l'introduction. L'introduction sert à définir le concept. Il ne s'agit pas d'un résumé introductif comme dans les encyclopédies standards.

Sections

Les différentes sections peuvent être divisées logiquement au moyen de titres et de sous-titres de différents niveaux.

  1. La structure de la plupart des pages est dictée par l'ontologie. Selon le type de page (maladie, médicament, etc.), certaines sections sont obligatoires, et d'autres recommandées mais facultatives. Des sections supplémentaires qui ne sont pas définies dans la classe ontologique d'une page peuvent être ajoutées.
  2. N'utilisez pas le niveau « Titre de la page », car le nom de la page fait déjà office de titre. Sauf de rares exceptions, le niveau de titre « Titre de la page »[note 1] ne devrait donc jamais être utilisé.
  3. Les titres de premier niveau doivent être des « Titres de section »[note 2].
  4. L'utilisation des titres doit procéder dans l'ordre, c'est-à-dire toujours passer d'un niveau « Sous-titre 1 » à un niveau « Sous-titre 2 » puis « Sous-titre 3 ».
    • Si vous devez utiliser des sous-titres de niveau 3 ou 4, demandez-vous s'il ne vaudrait pas la peine de diviser la page que vous êtes en train de construire.
  5. Les titres fournis dans l'éditeur visuel doivent impérativement être utilisés, car ils permettent la création automatique d'une table des matières, l'organisation du texte lorsque la page est consultée sur un mobile et une compatibilité entre navigateurs.
  6. Les liens et les références sont à proscrire dans les titres.
  7. Les titres ne devraient pas être mis en gras, en italique ou dans un quelconque autre format[note 3].
  8. Le nom d'une section ne doit pas commencer par un article grammatical, sauf lorsque ce dernier fait partie intégrante du sujet.
    Exemple: Stéthoscope et non Le stéthoscope, Lupus et non Le lupus

Nom des pages

  1. Le nom des pages doit être court et définir précisément le sujet.
  2. Le nom de la page ne doit pas commencer par un article grammatical, sauf lorsque ce dernier fait partie intégrante du sujet.
    Exemple: Stéthoscope et non Le stéthoscope, Lupus et non Le lupus
  3. Si plusieurs noms de page sont possibles, le plus juste par convention scientifique ou le plus commun doit être utilisé (il est possible de recréer des redirections à partir des termes alternatifs).
    Exemple: Diabète de type 2 plutôt que Diabète sucré.
  4. L'utilisation d'abréviation est évitée dans les noms de page (il est possible de recréer des redirections à partir des abréviations).
    Exemple: Virus de l'immunodéficience humaine et non VIH.
  5. Le nom de la page ne doit pas être au pluriel, à moins que le sujet de la page soit habituellement au pluriel
    Exemple: Connectivites peut être au pluriel, car la page traite d'une catégorie de pathologies appelées «Les connectivites». Par contre, Pneumonie est au singulier car la page traite d'une seule entité clinique
  6. Seul le premier mot porte une majuscule, sauf lorsque le nom de la page comporte un nom propre.
    Exemple: Insuffisance cardiaque et non Insuffisance Cardiaque, mais Syndrome de Sjögren et non Syndrome de sjögren.
  7. L'utilisation des parenthèses est réservée aux titres homonymes.
    Exemple: Maladie de Paget (os) et Maladie de Paget (seins)

Pages de redirection

Une page possède toujours un seul nom, mais il est possible de créer des redirections à partir de noms alternatifs.

Lorsqu'un concept peut être nommé de plusieurs manières, il importe de créer une page de redirection afin que cet homonyme renvoie vers la bonne page. Pour des exemples de redirections, il est possible de se référer à la liste des redirections. Tel que mentionné dans la section « Titres » la page devrait être nommée selon le terme le plus couramment utilisé. Lorsqu'un nom réfère à plusieurs concepts (homonymie), il importe de créer une page d'homonymie qui contiendra des liens vers les différents homonymes.

Exemple

Par ailleurs, les pages de redirection sont importantes dans le cas d'acronymes ou d'abréviations. En effet, une page de redirection « MCAS » devrait être créée qui dirige systématiquement vers la page « Maladie coronarienne athérosclérotique ». Ce genre de page améliore la navigabilité sur la plateforme. Les manières alternatives de nommer une page devraient toujours être considérées. Par exemple, « Manoeuvre de McBurney », « signe de McBurney » et « McBurney (signe clinique) » devrait tous les trois exister, les deux premières pointant vers la deuxième.

Références et notes

L'utilisation de références est obligatoire via l'interface de l'éditeur visuel (outil de gestion des références). La section « références » est obligatoire sur toutes les pages.

Les notes devraient être consignées dans le groupe «Notes».[note 4] Les notes doivent idéalement être concises et permettre une compréhension approfondie de la matière sans toutefois être essentielle à cette dernière.[note 5]

Notes

  1. = Titre de la page = en wikicode
  2. == Titre de section == en wikicode
  3. Étant donné que les titres sont des éléments de texte contrôlés et uniformisés par des styles CSS
  4. Ceci est une note.
  5. Ceci est une autre note.

Références

  1. « Pomme », Wikipédia,‎ (lire en ligne)