Sujet sur Discussion aide:Autoformation/Module 1

Réorganisation de la page

18
Antoine Mercier-Linteau (discussioncontributions)

@Michaël St-Gelais, je trouve et j'ai eu vent que la page d'autoformation est trop longue et décourage de nombreux volontaires.

Voici ce que je propose pour en améliorer la lisibilité:

  • Notions de base en droit d'auteur: c'est ultra important mais quand même raide pour débuter, les gens regardent les vidéos en droit d'auteur, trouvent ça trop technique, voient la contribution à Wikimedica comme difficile et abandonnent. Le droit d'auteur n'est pas supposé leur faire peur. Je suggère de déplacer ça à la toute fin et de mettre les vidéos de la bibliothèque en annexe.
  • Conventions d'écriture: je résumerais ça simplement en quelques points clés et je référerais à la page sur les conventions. Les éditeurs débutants ne les suivent pas de toute façon et on doit souvent les rappeler à l'ordre.
  • Structure d'une page: à simplifier.
  • Modèle: la section sur les données sémantiques est trop longue et devrait faire quelques phrases.
  • Convertir les sources: je supprimerais (en s'assurant que le vidéo est présent dans Aide:Références et notes).

Avec ça, je pense qu'on va pouvoir couper la taille de > 50% et augmenter notre taux de rétention.

@Isabelle Thibault, quelque chose à rajouter ?

Isabelle Thibault (discussioncontributions)

Je suis d'accord.

C'est une excellente page, qui comprend tout, mais ça peut être étourdissant au début quand on veut s'impliquer. Je garderais la page dans une "section aide", car toute l'info peut être pertinente, quand on cherche une façon de faire (pour les dessins d'Algorithme par exemple) mais ça n'a pas besoin d'être lu par les débutants, mais plus en référence quand on devient meilleur avec le concept. Je crois qu'on pourrait avoir une page qui dit en étape ce qu'on aimerait d'une première révision....genre,

1) on veut mettre les références dans l'article et surtout les ajuster à la fin du document.

2) éliminer les "up to date" le plus possible, utiliser les ressources en libre accès

3) description des standards d'écrire de base, tsé les listes de points, les caractères en gras, les sous sections

4) comment faire pour modifier le texte et ajouter des images, tableaux ect

5) corriger le français le lus possible et ajuster la syntaxes des phrases traduites par stat pearls

6)Vérifier la validation de l'information dans les textes, selon lee niveau de l'étudiant et

7) se familiariser au info-box et sémantique, mettre l'accent sur ces belles descriptions et s'assurer que les étudiants suivent les modèles.

je pense que ça peut être un bon début

Isabelle Thibault (discussioncontributions)

On pourrait séparer la page de l'autoformation en différents modules

Module 1: comment créer un compte, commet modifier un texte, comment communiquer efficacement avec le mentor, comment initier les 1eres modifications, références, standards d'écriture, premières étapes à la rédaction d'une page

Module 2: se familiariser avec les info-box, la sémantique

Module 3: comment insérer un tableau, un algorithme

Module 4: les droits d'Auteurs en profondeurs etc

Michaël St-Gelais (discussioncontributions)

Ça me convient, mais je préférerais que les modifications proposées soient fait sur une page brouillon (ou des pages brouillon) en gardant celle-ci intacte pour le moment. On ne modifie pas cette page pour des changements aussi majeurs.

Il reste que les pages d'aide en général sont à revoir : je n'ai pas eu le temps de tous les revoir et de les mettre à mon goût. Voulez-vous qu'on ouvre cette boîte de pandore ? C'est quand même beaucoup de travail revoir les pages d'aide.

Isabelle Thibault (discussioncontributions)

Si on y va par module, ça peut se faire quand même assez bien

Michaël St-Gelais (discussioncontributions)

Parfait ! @Isabelle Thibault, peux-tu stp mettre une tâche dans Gestion:Tâches expliquant ceci ? Dans la description de la tâche, tu peux mettre le lien permanent vers la présente discussion (Sujet:Xg9ek2kyozma5nnl) et expliquer ce que tu penses qu'on devrait faire. Ça va nous permettre de faire ça éventuellement sans l'oublier, mais sans le faire immédiatement non plus.

Antoine Mercier-Linteau (discussioncontributions)

Je crois que ça peut être plutôt simple:

  • Module 1:
    • Notions de base en droit d'auteur (sauf les vidéos)
    • Tour de l'interface
    • Poser vos questions
    • Discussions
  • Module 2:
    • Fonctions d'édition
    • Exemples de pages
    • Conventions d'écriture (très résumé, juste dire qu'il existe des conventions et qu'elles seront couvert en détail dans le module 3)
    • Ligne éditoriale
    • Structure d'une page:
      • Différencier les types de page
      • Bannières
    • Modèles (simplifiée)
    • Comment ajouter tel élément à ma page
  • Module 3:
    • Modèles (plus complète)
    • Algorithmes
    • Notions avancées en droit d'auteur
    • Conventions d'écriture détaillées


Les modules seront des sous-pages de la présente page.

Michaël St-Gelais (discussioncontributions)

Si on commence à rejouer là-dedans, dis-toi que ça va demander beaucoup de temps.

Est-ce du temps bien investi dans l'immédiat ? Les pages d'aide ne sont pas parfaites, mais je n'ai pas l'impression que ça va changer le recrutement ni la rétention de manière phénoménale à court terme. Est-ce que c'est une tâche critique pour la croissance de l'organisation ?

C'est sûr à 1000 % que si on se met à retravailler les pages de formation, je vais tout remettre en question, y compris les pages d'aide que tu avais fait initialement. Je trouve qu'il y a trop de pages d'aide et que certaines des pages d'aide ne sont pas claires du tout.

Je ne veux pas que ce soit fait à moitié si on le fait. Il faut que ce soit parfait.

J'ai aussi l'impression que tu vas vouloir simplifier des trucs qu'il ne faudra pas simplifier (ex le droit d'auteur). Si on marche dans la direction de la publication vers Pubmed, il faut que les processus et la formation des éditeurs soient impeccables.

Si vous voulez absolument faire un rebrassage, faites-le dans vos brouillons. Ne touchez pas à l'autoformation dans son état actuel.

Pour ma part, je crois qu'il faut fusionner les pages « d'aide » et l'autoformation. S'il le faut, faire plusieurs modules, mais éviter toute redondance entre l'aide et l'autoformation.

Bref, gros chantier. Pas certain de la plus value à court terme. L'attente serait la meilleure option à court terme.

Antoine Mercier-Linteau (discussioncontributions)

Non justement, je pense que ce sera court. On parle d'amélioration itérative ici, pas de refonte complète. Ça concerne aussi seulement la structure et pas le contenu.

Et je crois au contraire que ça pourrait changer la rétention. Beaucoup de gens se sont portés volontaires pour écrire du contenu et curieusement, beaucoup semblent être perdus lorsqu'on arrive à l'étape de l'autoformation (> 25-50% dans le projet Externat). Pour essayer de mitiger j'écris aux gens de passer rapidement les sections les plus arides.

Je ne dis pas que l'autoformation est en cause par contre, il y a certainement d'autres facteurs. Cependant, cette page est le premier contact que les gens ont avec le projet et revêt donc d'une grande importance.

J'améliore par ailleurs continuellement les pages d'aide à mesure que des choses changent et qu'on rajoute des capacités à la plateforme. Tout ça est en constante évolution. Si tu trouves des choses pas claires dans l'aide, je t'invite à en faire de même.

Il ne faut pas non plus confondre l'autoformation et l'aide. L'aide existe pour des questions précises et de l'information avancée. Le but de l'autoformation est de donner la base à un éditeur pour qu'il puisse se lancer rapidement dans ce pourquoi il s'est porté volontaire: écrire du contenu médical. Il y aura donc forcément redondance entre les deux (qu'on peut diminuer en faisant des inclusions). Wikipédia fonctionne de la sorte. Tu peux voire ça comme la partie Quick start que l'on retrouve dans tant de manuels d'appareils de consommation.

Si la structure mentionnée plus haut te va, je peux assembler tout ça dans mes brouillons et on verra ce que ça donne.

Michaël St-Gelais (discussioncontributions)

Allons-y pour une refonte complète !

Idéalement, il faudrait que les modules soient progressifs et qu'on puisse les « prescrire » à quelqu'un.

  • Ex. étudiant qui fait DDU --> module 1 à 3
  • Ex. médecin qui fait de la révision --> module 1 seulement

Chaque module pourrait avoir une page OU être constitué d'une série de plusieurs petites pages. Une préférence ?

______________

  • Module 1 (thématique = la base)
    • Briser le wiki ?
    • Tour de l'interface (la vidéo est à refaire)
      • Je pense qu'il faudrait faire des petites vidéos plus courtes qui découpent en plus petits morceaux l'information plutôt qu'une vidéo de 25 minutes. Ma vidéo est pas mal ordinaire en plus. Eurke.
      • Je pense que le tour de l'interface que tu as fait en guidedtours remplit une bonne partie des cases.
    • Poser vos questions
    • Utilisation des pages de Discussions
    • Fonctions d'édition
    • Brouillons
    • Exemples de pages
  • Module 2 (thématique = les données sémantiques et la compréhension de la structure du wiki)
  • Module 3 (thématique = les règles)
    • Droit d'auteur
    • Trouver des images en libre accès
    • Trouver, évaluer et citer ses sources
    • Ligne éditoriale simplifiée (ce l'est déjà)
    • Conventions d'écriture simplifiée (je continuerais à utiliser des inclusions depuis la page principale des conventions d'écritures)
  • Module 4 (fonctions avancées)
    • Algorithmes
    • Wikicode
    • Aide:Inclusion (à fusionner dans le module 4)
    • Aide:Médecine basée sur les évidences --> il faudrait détailler beaucoup mieux comment faire pour mettre des données épidémiologiques dans les modèles
    • Création d'une page
    • Redirections
  • Pas dans un module, juste à garder idem.


_____________________

Rubriques d'aide à supprimer :

  • Aide:Assistant d'importation de pages --> j'aimerais mieux que ce soit seulement toi et moi qui s'occupe de ça à l'avenir, donc je supprimerais carrément cette page.
  • Aide:Livres --> étant donné que ce n'est plus supporté, je crois qu'il faudrait simplement supprimer cette rubrique. De toute manière, le seul livre que nous avons pour le moment, c'est le livre de l'externat que tu débogues de temps en temps.
  • Aide:Fonctions sémantiques --> ce n'est pas tellement une rubrique d'aide que d'une explication par rapport à l'utilité des données sémantiques.
  • Aide:Balises et données sémantiques --> à amalgamer dans le module
  • Discussion --> à fusionner avec le module 1
  • Aide:Modèles --> à fusionner avec le module avec les modèles
  • Références et notes --> à fusionner avec le module 2
  • Éditeur visuel --> à amalgamer dans le module 1
Antoine Mercier-Linteau (discussioncontributions)

Ça commence à avoir du sens ! J'aime l'idée des modules progressifs. Cette structure me vas.

Comme ça doit être court, je préconise de tout mettre sur une page car l'autoformation ne sert pas le même objectif qu'une page d'aide. La première éduque tandis que l'autre sert de référence.

Concernant la fusion de l'autoformation et de l'aide, tel que mentionné plus haut, ce n'est pas une bonne idée. J'élabore sur les raisons:

  • Ça va rallonger beaucoup l'aide.
    • Par exemple la page sur trouver et citer ses sources est beaucoup trop longue pour cet usage. Il faut entraîner les éditeurs à s'y référer, pas à l'assimiler en entier.
  • L'approche que l'on doit avoir, c'est de montrer où sont les ressources et autonomiser nos éditeurs, pas de leur montrer comment 100% du wiki fonctionne.
  • Ça va diminuer notre capacité à faire des références à des pages précises de l'aide dans nos commentaires et dans l'interface.
  • Ça va diminuer notre capacité à prioriser la pédagogie dans l'autoformation. Par exemple, dans l'optique où l'on prescrit des modules, on pourrait vouloir parler du droit d'auteur 2 fois (superficiel en premier et détaillé plus tard [les réviseurs doivent au moins avoir une base]).
  • Il y a des choses qu'on peut vouloir carrément virer de l'autoformation. Les modèles par exemple, car personne ne semble comprendre ça d'emblée. Il faut de l'expérience pour saisir la chose. Par contre, on peut rajouter un petit icône ? dans l'interface lorsqu'on ouvre un modèle. Un utilisateur va cliquer dessus et se retrouver sur Aide:Modèles.
  • Et si un jour on décide de faire un outil interactif comme sur Wikipédia ?
  • Il va inévitablement se rajouter des pages (gestion de la rédaction ? flashcards ? formation continue ? lien Wikimedica + Pubmed ?) Ces pages ne feront pas partie de l'autoformation.
  • Pratiquement tous les manuels informatique auquel je me suis frottés dans ma carrière sont construit en mode

Il faut se rappeler pourquoi on a créé l'autoformation: parce que l'aide était trop longue et aride. Wikimedica est beaucoup trop complexe pour tout mettre dans une formation d'une heure.

Michaël St-Gelais (discussioncontributions)

Et si chaque sujet était une petite page d'aide en soi, est-ce que ça changerait ton avis sur le sujet ?

On a surtout fait l'autoformation parce que c'était rendu impossible de former chaque individu individuellement, ça faisait un travail infini !

Comme on le dit si souvent partout ailleurs sur le wiki, il faut limiter au maximum la duplication de l'information. Dans ce cas-ci, l'aide et l'autoformation ont beaucoup de duplication...

Antoine Mercier-Linteau (discussioncontributions)

Non, l'aide va devenir super complexe et difficile à entretenir. L'autoformation va devenir trop grosse et aride. Lorsque l'information peut être réutilisée, on se sert d'une inclusion, mais l'autoformation est avant tout pédagogique.

On a de toute façon pas vraiment le choix de séparer les pages.

Par exemple, prend la section Ressources documentaires en libre accès dans l'autoformation. C'est pédagogique, ça résume les grands principes et ça réfère à la page Aide:Trouver, évaluer et citer ses sources. En revanche, on ne peut pas inclure cette énorme page (qui sera appelée à grossir encore) dans l'autoformation. Elle est beaucoup trop volumineuse et indigeste. On veut par contre une telle page pour pouvoir la référer à un éditeur qui essaye de trouver du contenu libre accès pour écrire son article.

Un autre exemple, c'est la page de l'éditeur visuel, elle est énorme elle aussi et contient beaucoup d'information triviale qui n'a pas sa place dans l’autoformation. Il faut quand même que cette information existe pour que les éditeurs (ou une IA) puisse s'y référer au besoin.

Oui il faut limiter la duplication d'information, mais dans ce cas-ci l'objectif de l'aide et de l'autoformation n'est pas le même. C'est comme un manuel de cours de système au pré-clinique vs une page de maladie sur Wikimedica. L'une sert à la formation, l'autre sert de référence.

Michaël St-Gelais (discussioncontributions)

À un moment donné, y'a comme une limite de ce qu'on peut épargner aux éditeurs pour apprendre à utiliser le wiki. Il ne faut pas tout mettre en un paragraphe et référer à une plus grosse page.

Quand on aide qqn ou qu'on forme qqn, c'est de la pédagogie dans les deux cas. Donc on doit être pédagogique dans les deux cas.

Il faut que la personne lise un peu pour comprendre : on ne peut pas tout épargner aux éditeurs.

Je vais te faire une refonte de l'aide dans mes brouillons. On verra ce que tu en penses.

Mais il faudra accepter de supprimer des pages non utiles (Aide:Assistant d'importation de pages, Aide:Livres, Aide:Fonctions sémantiques) et d'autres à fusionner avec d'autres sections (Aide:Balises et données sémantiques, Discussion, Aide:Modèles, Références et notes, Éditeur visuel).

Antoine Mercier-Linteau (discussioncontributions)

J'ai repensé à ta proposition de morceller les pages pages d'aide et si on parvient à avoir un bon système de classement derrière ça pourrait le faire. C'est vrai que l'industrie va dans cette direction (les pages d'aide sont vues comme une base de connaissance).

Ça reste néanmoins un travail complexe qui va me demander de la programmation.

Reste que mon but était de faire des petites améliorations pour augmenter l'ergonomie de l'autoformation et la rendre plus agréable à parcourir et ainsi augmenter la rétention.

Parlons en de vive voix. Il y a du courant qui ne passe pas.

Michaël St-Gelais (discussioncontributions)

Je pense qu'au contraire on commence à être pas mal d'accord !

Antoine Mercier-Linteau (discussioncontributions)

Parlons-en quand même.

Antoine Mercier-Linteau (discussioncontributions)

Nous nous sommes mis d'accord sur le plan suivant:

  • Michaël va faire une proposition d'autoformation divisée en modules
  • Antoine va transformer le système d'aide pour qu'il fonctionne davantage comme une base de connaissances et soit structuré en questions plutôt qu'en gros thèmes (voir Gestion:Tâches/Liste/619)
  • une fois le système d'aide fait, des inclusions pourront être faites pour remplacer certaines parties de l'autoformation.