Gestion:Politiques/Conventions

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 microvascularisation → dommage 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.

Médias dans une page

Diagramme de coeur

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 à briser 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.

Médias

L'ajout de médias doit impérativement se faire selon les règles de droits d'auteurs de Wikimedica. Avant d'ajouter tout media, il est important d'effectuer une recherche afin de s'assurer qu'un média similaire n'existe pas déjà. Si c'est le cas et que la version qui s'apprêtait à être téléversée est meilleure et est en mesure de remplacer l'utilisation du media sur toute les pages qui en font usage, il suffit de télécharger une nouvelle version sur la page du media même. Pour des conseils concernant le choix de médias, consultez le guide d'importation de fichiers.

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

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

Pertinence

1. Le média doit ajouter de l'information au contenu de la page ou en augmenter sa pertinence.
2. À moins d'exceptions, le média ne sert pas seulement de décoration.

Nom

1. Ne surtout pas nommer 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

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.

Pages

Structure de page

Il est recommandé de débuter une page par une introduction sur le sujet, et qui peut même faire office de résumé de la matière. Pour le reste du texte, les différentes sections, elles peuvent être divisées logiquement au moyen de titres et de sous-titres de différent niveaux.

1. Ne pas donner de titre principal, car le nom de la page fait déjà office de titre. Sauf exceptions, le niveau de titre «Titre de la page» ( = Titre de la page = en wikicode) ne devrait donc jamais être utilisé.
2. Les titres de premier niveau doivent être des «Titres de section» ( == Titre de section == en wikicode).
3. L'utilisation des titres doit procéder dans l'ordre, c'est à dire ne pas passer d'un niveau «Sous-titre 1» à un niveau «Sous-titre 2» sans avoir passé par le 3.
4. Les titres fournis par le wiki 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.
5. Sauf exceptions, les liens et les références sont à éviter dans les titres.
6. Comme les titres sont des éléments de texte contrôlés et uniformisés par des styles CSS, ils ne devraient pas être mis en gras, en italique ou dans un quelconque autre format.

Il est à noter que certains types de pages mandatent une structure spéciale, comme les pathologies (épidémiologie, étiologie, physiopathologie, etc.), les tests, etc.

Organisation

L'organisation des pages réfère à la manière dont elles sont mémorisées sur le wiki et accédées par un URL ou des liens. Les pages sont organisées selon trois groupes : les thèmes, les cours et les concepts. Généralement la plupart des pages se retrouveront dans l'espace principal (Maladie de Parkinson), c'est-à-dire qu'elles ne seront pas des sous-pages (Neurologie/Maladie de Parkinson). Dans le doute, créez une page dans l'espace principal et si pertinent, elle pourra être déplacée plus tard.

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, des pages d'administration ou des pages concernant un sujet bien particulier. Tout ce qui concerne la médecine doit se retrouver dans l'espace de nom principal, c'est-à-dire pas de EspaceDeNom: en avant du titre de la page.

Les pages peuvent ensuite être classées dans différentes catégories. Les pages de catégories commencent par Catégorie:Nom_de_la_catégorie. Pour une liste complète des catégories de Wikimedica, se référer à la liste des catégories.

Concepts

Les concepts sont un terme vague qui regroupe tout ce qui est utilisé en clinique comme les pathologies, les organes, les systèmes, les tests, les marqueurs, etc. C'est la catégorie où le plus de pages se retrouveront. Voici quelques exemples:

• Dégénérescence corticobasale
• Embolie pulmonaire
• Gestion du stress en contexte d'urgence

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:

• Maladie de Paget
  • Maladie de Paget (os)
  • Maladie de Paget (seins)

Certains concepts, en raison de leur utilisation précise et de la dépendance qu'on une foule de pages envers eux, sont attitrés à des espaces de noms particuliers (ex: Signe, Symptôme, etc.) afin d'en assurer un contrôle plus strict. Les mêmes conventions s'appliquent à ces concepts qu'à ceux dans l'espace de nom principal.

Cours

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. C'est aussi sur la page de cours que l'on retrouve la possibilité de télécharger le cours sous forme de livre PDF. Contrairement au thème, son organisation favorise une approche pédagogique de la connaissance et cible un public étudiant. Afin de ne pas dupliquer l'information, un cours emprunte ses pages au thème qu'il enseigne (par exemple, MED-1208/Protéinurie renvoie à Néphrologie/Protéinurie)

• MED-1208
  • Chapitre 3
    • Protéinurie
      • MED-1208/Protéinurie (notes de cours, renvoie à Néphrologie/Protéinurie)
      • MED-1208/Protéinurie/Flashcards (flashcards)
    • Hématurie
      • MED-1208/Hématurie (notes de cours, renvoie à Néphrologie/Hématurie)
      • MED-1208/Hématurie/Flashcards (flashcards)
    • Filtration glomérulaire
      • MED-1208/Filtration_glomérulaire (notes de cours, renvoie à Néphrologie/Filtration_glomérulaire)
        • MED-1208/Filtration_glomérulaire/Flashcards (flashcards)

Thèmes

Un thème organise la connaissance en différents sous-thèmes et favorise une approche plus utilitariste de la connaissance. Il cible un public ayant déjà une bonne maîtrise du domaine et se veut être une référence plutôt qu'un outil d'apprentissage. Les sous-pages d'un thème décrivent des concepts théoriques et non cliniques, par exemple, le concept de la protéinurie, son mécanisme, sa mesure, ses causes, son approche, sont consignées dans la page Néphrologie/Protéinurie. La protéinurie comme concept clinique, donc son épidémiologie, étiologie, diagnostic, traitement, etc, relèverait de la page Protéinurie.

• Néphrologie
  • Néphrologie/Protéinurie
  • Néphrologie/Hématurie
  • Néphrologie/Filtration_glomérulaire

Règles entourant le titre des pages

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

1. Les titres doivent être courts et définir précisément le sujet.
2. Le titre ne doit pas commencer part 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 titres 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 titres (il est possible de recréer des redirections à partir des abréviations).

   Exemple: Virus de l'immunodéficience humaine et non VIH.

5. Le titre 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 titre 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èse est réservée aux titres homonymes.

   Exemple: Maladie de Paget (os) et Maladie de Paget (seins)

Références et notes

L'utilisation de références est obligatoire.

1. L'outil de gestion des références dans l'éditeur visuel doit être utilisé tant pour les notes que pour les références.
2. Les notes devraient être consignées dans le groupe «Notes».

   Les notes doivent idéalement être concises et permettre une compréhension approfondie de la matière sans toutefois être essentielle à cette dernière.

3. Pour le moment, Wikimedica n'impose pas de format de citation des sources, cependant, ce dernier devrait être constant au long de la page.

   Idéalement, une référence devrait contenir un lien vers l'ouvrage afin qu'il puisse être facilement consulté par le lecteur.