« Gestion:Politiques/Conventions » : différence entre les versions

De Wikimedica
(Correction note et ajout d'explication pour les abréviations)
(Précisions sur le nommage des images)
Ligne 39 : Ligne 39 :


=== Structure de page ===
=== Structure de page ===
Il est recommandé de débuter une page par un article d'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.
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.
# 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" ( <code>= Titre de la page =</code> en wikicode) ne devrait donc jamais être utilisé.
# 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" ( <code>= Titre de la page =</code> en wikicode) ne devrait donc jamais être utilisé.
# Les titres de premier niveau doivent être des "Titres de section" ( <code>== Titre de section ==</code> en wikicode).
# Les titres de premier niveau doivent être des "Titres de section" ( <code>== Titre de section ==</code> en wikicode).
Ligne 66 : Ligne 66 :
L'ajout de médias doit impérativement se faire selon les règles de [[Wikimedica:Droit d'auteur|droits d'auteurs de Wikimedica]]. Autrement, ils doivent autant que possible suivre les principes suivants:
L'ajout de médias doit impérativement se faire selon les règles de [[Wikimedica:Droit d'auteur|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 [[Wikimedica:Importation de fichiers|guide d'importation de fichiers]].
# 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 [[Wikimedica:Importation de fichiers|guide d'importation de fichiers]].
# Être nommés de manière la plus descriptive possible sans utiliser d'articles et débuter par une majuscule. Rappelez-vous qu'il doit être possible de rechercher des médias textuellement.
# Être nommés 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" plutôt que "Diagramme de coeur"
#: "Un diagramme de coeur" ou "coeur" ou "dg coeur" plutôt que "Diagramme de coeur"
#: "Rx AP pneumonie" devrait être "Pneumonie de la base droite (radiographie antéro-postérieure)"
# 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.
#: "Radiographie de poumons normaux" devrait être "Poumons normaux (radiographie)"
#: "TDM de poumons normaux" devrait être "Poumons normaux (tomodensitométrie)"
# Être de la meilleure qualité possible.
# Être de la meilleure qualité possible.
# Ne pas contenir de description, titres, numéros de figures, noms dans l'image.
# Ne pas contenir de description, titres, numéros de figures, noms dans l'image.
Ligne 85 : Ligne 89 :


=== Organisation ===
=== 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|<s>Neurologie/Maladie de Parkinson</s>]]). Dans le doute, créez une page dans l'espace principal et si pertinent, elle pourra être déplacées plus tard.
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|<s>Neurologie/Maladie de Parkinson</s>]]). 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 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.

Version du 11 juin 2017 à 02:11

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.

Texte

Contenu

Préférablement, le texte dans les pages de Wikimedica doit être sous forme de prose et non de liste ou de sucession d'énoncés reliés par des symboles. 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

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.

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

Abréviations

Les abréviations dans le domaine de la santé sont choses courantes et largement utilisées afin de simplifier la lecture de texte. Or, elle 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éfinies dans les textes qui les utilisent. La première fois qu'une abréviation est utilisée dans une page, elle doit être définie au long. Pour le reste de la page, l'abréviation peut être utilisée. Par exemple:

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.

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.

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. Autrement, ils doivent autant que possible suivre les principes suivants:

  1. 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. Être nommés 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" plutôt que "Diagramme de coeur"
    "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.
    "Radiographie de poumons normaux" devrait être "Poumons normaux (radiographie)"
    "TDM de poumons normaux" devrait être "Poumons normaux (tomodensitométrie)"
  4. Être de la meilleure qualité possible.
  5. 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.
  6. É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.
    Éviter d'importer des tableaux sous forme de texte
  7. 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.
  8. Une catégorie de droits d'auteurs doit être ajoutée aux média.
    1. J'ai trouvé ce fichier sur le web: {{Fichier_du_web}}
    2. L'auteur de ce fichier est connu mais je ne sais pas si j'ai le droit de m'en servir: {{Fichier_permission_inconnue}}
    3. Je ne connais pas l'auteur de ce fichier: {{Fichier_auteur_inconnu}}
    4. Ce fichier provient d'un projet Wikimedia (Wikipédia, Commons, etc.): {{Fichier_Wikimedia}}
    5. L'auteur de ce fichier m'a donné l'autorisation d'en faire don à Wikimedica: {{Fichier_don_autre_auteur}}
    6. Je suis l'auteur de ce fichier en j'en fait don à Wikimedica: {{Fichier_don_auteur}}

Pages

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

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)

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.

Titres

  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)

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]

Références

Notes

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