Journée documentation

La "Journée documentation" est un jour spécifique dédié à l'amélioration de la documentation francophone de Moodle. Plusieurs telles initiatives ont déjà eu lieu par le passé:

• Infos sur la journée de documentation de 2017
• Infos sur la journée de documentation de 2016

Une discussion récente a motivé une nouvelle journée de documentation en 2023.

ATTENTION : cette page est une ébauche issue de la journée 2017 et va évoluer (au fil de la journée) pour reprendre les informations importantes ! Pensez à vérifier dans son historique s'il y a des changements.

Principe

Le principe est de mobiliser la communauté francophone, sur une journée, sur un élément bien précis : la documentation Moodle francophone !

Chacun peut, selon ses connaissances et compétences, son envie, son temps disponible... choisir de corriger quelques fautes d'orthographe en 10 minutes, rédiger une page qui manquait cruellement, améliorer des pages existantes, finir de traduire des pages existantes, créer des redirections...

Date

• Date : jeudi 9 novembre 2023
• Horaire : rien de spécifique, chacun fait comme il veut/peut.

L'idée et le principe : que cette journée mobilise, pour pousser un maximum de personnes de la communauté à agir sur la documentation ; vous pouvez donc commencer dès aujourd'hui (et continuer bien après) !

Nous prévoyons d'utiliser le tchat de l'espace Moodle en français. Les horaires seront indiqués pour la France métropolitaine.

Contribuer

Qui peut contribuer ?

Tout le monde !!!

En effet, chacun peut contribuer, à son niveau et en fonction de ses connaissances et compétences, son envie, son temps disponible... Il n'y a pas de contribution modeste ! Chacune compte : relecture, correction d'orthographe, commentaire... Bref, tout est bon à prendre : ce qui est commencé par quelqu'un pourra être amélioré par quelqu'un d'autre, puis finalisé par une autre personne.

Comment contribuer

Commencez par lire les pages suivantes :

• Contribution à la documentation
• Comment éditer une page de documentation

Assurez-vous d'avoir un compte sur moodle.org, puis :

• participez à la discussion sur le Chat du Docathon
• connectez-vous à la documentation (avec votre nom d'utilisateur / mot de passe de moodle.org) et lancez-vous !

Outils disponibles

• Le chat Moodle francophone pour des échanges écrits en direct
• N'hésitez pas sinon à poser vos questions sur le forum dédié à la documentation Moodle

• Pour les copies d'écran, vous pouvez utiliser le site de démonstration de Moodle (réinitialisé toutes les heures, à l'heure pile).

Organisation de la journée

Chacun peut démarrer à l'heure de son choix. Une "permanence" sera assurée sur le chat à 9h au plus tard.

Un salon sur Matrix.org a été dédié à la coordination de cette journée. Pour le rejoindre : https://matrix.to/#/!vkNWcEJGVIlfTXUtRZ:matrix.org?via=matrix.org

Idées d'éléments à traiter

Si vous manquez d'idées pour participer à la documentation, vous pouvez déjà vous atteler aux pages à finir de traduire, aux pages à l'état d'ébauches et corriger les pages contenant des liens incorrects.

Consultez les "pages les plus demandées", et créez-les ! Cela maximisera l'efficacité, car certaines font cruellement défaut.

Vous pouvez aussi créer les liens entre ce que Moodle créé automatiquement (liens "Documentation pour cette page") et les noms "parlants" des pages, avec une simple redirection. Par exemple pour la page mod/quiz/mod, le contenu est :

#REDIRECTION [[Paramètres du test]]

Regardez les modifications récentes pour voir comment sont apportées les modifications, et savoir quoi relire pour correction

Travail prévu

Merci à chacun d'indiquer ici le travail qu'il prévoit de faire. Cela permettra de s'organiser au mieux.

• Patrick L. : tentative de coordination ;o) On peut me trouver sur le salon Matrix dédié
• Séverin T. : Permanence / assistance sur le tchat. Compléter les différentes pages avec les informations sur les nouvelles versions depuis avril 2023.
• Nicolas M. : Coordination, nettoyage des catégories, renommages
• Olivier V. : [à préciser ultérieurement]
• Sébastien M. : [à préciser ultérieurement]
• Luiggi S. : [à préciser ultérieurement]
• Benoit T. : [à préciser ultérieurement]
• Karine D. : corrections fautes d'orthographes, rajouter certaines infos sur l'activité Atelier présentes dans le forum, si le temps : rédiger une première contribution (petite :) )

Travail en cours

Merci à chacun de noter ici :

• sur une ligne, la/les page(s) sur laquelle vous travaillez actuellement, pour que personne d'autre n'y touche
• sur une autre ligne, les pages sur lesquelles vous avez travaillé, afin que quelqu'un d'autre puisse les relire/corriger/améliorer

• Séverin T. :

• en cours : compléter les différentes pages avec les informations sur les nouvelles versions depuis avril 2023
• fait :

• Nicolas M. :

• en cours :
• fait :

• Luiggi S. :

• en cours :
• faits :

• Patrick L. :

• en cours : Administration en ligne de commande
• faits :
  • Bloc Serveurs du réseau (à relire)
  • Paramètres des restrictions d'accès (à relire), attention, pas mal de différences avec la version English.
  • FAQ sur les restrictions d'accès (à relire)

• Olivier V. :

• en cours :
• faits :

• Sébastien M. :

• en cours :
• faits :

• Benoit T. :

• en cours :
• faits :

• Karine D. :
  • en cours :
  • Faits : doc sur l'activité Atelier (correction orthographique, mise en page) + MAJ lien de la vidéo de présentation Atelier Moodle v4.0 par Moodle Academy

Pour l'avenir

A partir du vendredi 10 novembre 2023, nous essayerons de tirer le bilan de cette troisième édition de la journée documentation.

Autre

N'hésitez pas à apporter vos remarques sur l'organisation, le déroulement, les pistes d'amélioration de cette démarche, dans le forum dédié, ou cette page, ou la page de discussion liée.