Wikimedica:Conventions

De Wikimedica
Aller à : navigation, rechercher
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 peut fastidieuses et contre-productives, mais elles visent à optimiser la qualité du contenu de Wikimedica et assurer la pérennité du projet sur le 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

1 Texte

1.1 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:

  • coeur: maladie coronarienne athérosclérotique (MCAS)
  • reins: néphropathie diabétique
  • oeil: rétinopathie diabétique
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.

1.2 Listes

Les listes sont encouragées, sauf lorsqu'elle viennent en remplacement de la prose. Les format de listes offerts par l'éditeur de WIkimedica ou programmées en HTML par le wikicode devraient toujours être utilisées. Des listes créers textuellement ne devraient jamais être crées en raison de leur tendance à la désorganisation et au problème d'affichage qu'elles causent.

Une liste devrait idéalement être mise en contexte par une courte phrase la précédent.

1.3 Symboles

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

  1. Streptocoque β-hémolytique du groupe A, β-bloqueur, mais pas ¢ au lieu cellule
  2. diabète → complications au lieu de le diabète entraîne des complications

1.4 Abréviations et acronymes

Les abréviations et 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éfinie 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.

1.5 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.

1.6 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.

1.7 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

2 Médias

L'ajout de médias doit impérativement se faire selon les règles de droits d'auteurs de Wikimedica. Autrement, ils doivent autant que possible suivre les principes suivants: Avant d'ajouter tout media, il est important d'effectuer une recheche afin de s'assurer qu'un media similaire n'existe pas déjà. Si c'est le cas et que la version qui s'apprêtait à être téléverser 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.

2.1 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'abbré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)"

2.2 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é, 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.

2.3 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.

3 Pages

3.1 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.

3.1.1 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 ou le plus de pages se retrouveront. Voici quelques exemples:

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:

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.

3.1.2 Cours

Un cours permet l'organisation de pages en différents chapitres et associe à ces derniers des notes, des flashcards, 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)

3.1.3 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.

3.2 Titres

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: Séthosocope et non Le stéthoscope, Lupus et non Le lupus.
  3. Si plusieurs titres son 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'abbréviation est évitée dans les titres (il est possible de recréer des redirections à partir des abbré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)

4 Références et notes

L'utilisation de références est une excellente idée!

  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".[Note 1]
    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 2]
  3. Pour le moment, Wikimedia n'impose pas de format de citation des sources, cependant, ce dernier devrait être constant au long de la page.[1]
    Idéalement, une référence devrait contenir un lien vers l'ouvrage afin qu'il puisse être facilement consulté par le lecteur.[2]

4.1 Références

4.2 Notes

  1. Ceci est une note.
  2. Ceci est une autre note.