Bonjour à tou(te)s,
La documentation est un élément important pour l'utilisation de Moodle. Autant la version anglaise est bien maintenue et (relativement) à jour, autant la version francophone souffre de nombreux manques, son élaboration étant totalement bénévole.
L'année dernière, nous avons lancé une journée de documentation, qui s'est tenue le mercredi 10 février 2016. Une page de documentation liée à cette journée avait été créée pour cela. Une discussion récente a fait apparaitre le souhait de renouveler une telle journée.
Je vous propose donc une journée liée à l'amélioration de la documentation francophone pour 2017. Le principe étant de s'aider et se motiver mutuellement (via des conseils par tchate, voire visio) au cours d'une journée conviviale, afin d'améliorer plusieurs aspects de la documentation. Chacun participant selon ses moyens, compétences, disponibilités, envies...
Le premier problème (comme l'année dernière) reste de déterminer une date. Certain(e)s préfèrent pendant les vacances (ou les week-end), et d'autres au contraire ! De toute façon, il sera impossible de contenter tout le monde.
Il me semble que l'année dernière, cela n'avait pas trop mal fonctionné. Je vous propose donc de faire cela dès la semaine prochaine, le mercredi 15 février 2017.
Si cela vous convient, merci de le confirmer ! Sinon, merci d'indiquer le plus clairement possible les dates (ou jours...) qui seraient possibles pour vous, ou au contraire qui vous seraient impossibles. Nous essayerons en fonction des avis exposés de trouver la date qui répond à un maximum de possibilités.
Séverin
PS : je ferai ultérieurement du ménage sur la page liée à la journée de documentation
Excellent, je participerai comme l'an dernier, dans la mesure de mes possibilités.
Merci pour l'organisation !
Une suggestion: renommer la page de l'action de l'année dernière, en ajoutant la date, et faire une page toute neuve pour l'action de cette année.
Ça permettra 1) de garder une référence sous le coude, et 2) de conserver une archive plus ou moins intacte du travail de l'an dernier.
C'est bien ce qui est prévu !
Et ce n'est pas pour rien que dans mon message, le premier lien vers la journée documentation pointe vers 2.x (pour garder la page de 2016), et celui de fin de message vers la 3.x
Et que j'ai supprimé la page de discussion associée à la 3.x (uniquement).
Au temps pour moi, je n'avais pas vu la subtilité
Pas beaucoup de retours jusqu'ici. Peut-être que nous ne serons que deux
Bonjour
Toujours là !!!
Enfin, cela dépendra de la date en effet car beaucoup de lait en cours de cuisson à surveiller attentivement pour éviter tout débordement... (en mode "je regarde trop top chef ")
PS j'ai vu le 15/02/17 donc OK POUR MOI !!!!!
Moi idem...
Mais tout le mois de mars je serai de l'autre côté de la méditerranée. A priori aléatoirement connecté tout de même.
Salut Luiggi,
Cool, que tu sois disponible
Le site que tu avais mis à disposition de la communauté l'année dernière pour la journée de documentation (pour des copies d'écran) serait toujours disponible pour mercredi ?
Séverin
Hello
Oui, présent !
Donc oui, je vais le mettre à jour en 3.2.1+ (il est ce jour en 3.2)
J'ai préparé un espace d'accueil pour tout nouveau compte, un espace test (avec pas grand chose) pour le côté vue étudiante, et la possibilité de créer son propre espace de "jeu" en tant qu'enseignant
J'ai ajouté la possibilité de changer le thème facilement (menu dans le bandeau du haut)
J'ai ajouté le process dans ta page docathon
Voilà
Super
Bonjour,
L'année dernière, j'avais regretté de ne pas pouvoir participer. En revanche, j'ai un peu de disponibilité ces jours-ci, et je serai donc heureux de pouvoir donner un coup de main mercredi prochain 15 février, ou un autre jour de semaine d'ici fin février.
Je ne suis peut-être plus très à la page, ayant dû mettre de côté pendant quelques mois mon intérêt pour Moodle. Mes plates-formes sont toujours en 2.5 et 2.6... Un petit travail de traduction de la documentation m'aidera sans doute à me remettre à niveau !
Si possible, peut-être pourriez-vous repréciser les "pré-requis" à préparer pour être opérationnel le jour J . A titre d'exemple, je suppose :
- qu'il faut avoir un compte sur docs.moodle.org
- qu'il est souhaitable d'avoir lu a minima les recommandations pour contribuer à la documentation
Dans le fil de discussion de l'année dernière, il y avait aussi quelques indications préalables sur le travail à faire. J'imagine (peut-être à tort) que les tâches avaient ensuite été spécifiquement attribuées aux participants, par les Gentils Organisateurs ...
J'imagine enfin que des précisions seront données quant au mode de communication éventuel mis en place pour cette journée commune de travail.
Patrick
Bonjour Patrick,
Et bien, super que tu puisses participer cette année !
Je vais effectivement re-travailler un peu la page de cette journée de documentation, en tenant compte de tes suggestions, et en essayant de préciser un maximum d'éléments
Séverin
Hey la bande,
Je découvre le principe et par la même occasion que c'est dans 48h ... ouch dur !
Il y a des espaces de chat, irc, hangout, ... ou tout se passe de manière asynchrone et par écrit ?
Paul newbie dans la machine
Bonjour Paul,
Effectivement, la décision a été prise (très rapidement), et la date fixée à (très / trop ?) courte échéance.
Je sais qu'on va du coup "perdre" du monde, mais tant pis. De toute façon, entre les différentes périodes de vacances, ceux qui sont disponibles plutôt pendant les vacances, ou hors vacances, pendant la semaine, ou le week-end, on ne peut jamais contenter tout le monde... donc, on fera avec les présents
Il y aura a minima le chat Moodle.
Les différentes informations sont dans la page de documentation dédiée à la journée documentation
Séverin
Bonjour à tou(te)s,
J'en serai ! Je suis tombé sur la date un peu par hasard...
A priori je devrais pouvoir trouver un peu de temps pour me joindre à l'effort de groupe dans la joie et la bonne humeur, comme d'hab'
A demain !
Patrick
> J'en serai ! Je suis tombé sur la date un peu par hasard...
Pas reçu l'annonce faite hier par Séverin ? J'avoue que ça m'inquiète un peu (pas pour toi, rassure-toi ).
Nicolas
Je suis prise presque toute la journée, j'essaierai néanmoins de rejoindre le groupe sur le temps plutôt du midi ou fin d'apres-midi
Si j'y arrive, je peux travailler un peu sur la doc des badges, car je suis en plein dans le sujet
Emilie
Bonjour,
De nombreuses informations utiles avaient été données l'année dernière, en cours de journée, via le chat. Est-ce que quelqu'un aurait eu la bonne idée d'enregistrer ces informations ? Si oui, il faudrait idéalement récupérer la substantifique moelle dans la documentation (ou a minima partager cet enregistrement).
Séverin
Bonjour,
Ce mercredi... trop juste pour moi.
Car j'aurais aimé travaillé sur la doc des "visites guidées" qui est une nouveauté qui m'intéresse beaucoup mais sur laquelle je n'ai pas encore complètement fait le tour. Surtout les sélecteurs.
Quoi qu'il en soit si cette page existe (vierge ou pas) je m'engage à la peaufiner à n'importe quel moment et assez rapidement.
En tout cas avant la fin du mois car après je migre pour un mois entier vers un autre continent.
Bonjour Daniel,
Rien ne t'empêche de commencer le travail dès demain, et de le compléter et améliorer plus tard
D'ailleurs, ça tombe bien, les visites guidées sont dans la liste d'idées sur lesquelles travailler
Séverin
Oui Séverin,
Je commencerai dès que possible à m'impliquer sur les visites guidées.
Mais pas aujourd'hui.
En fait plutôt que de trop m'inspirer de la documentation en anglais (chapitrage etc...) je pense plutôt, après une description de l'intérêt aussi claire que possible de ce nouveau dispositif, suivie d'une méthodologie de mise en oeuvre du type "recette de cuisine".
A l'usage du pédagogue lambda qui est toujours ma référence.
Tant pis si cela fait double emploi avec une documentation plus... technique.
Il faut d'abord que j'en finisse avec l'emploi ... facile... des sélecteurs.
> En fait plutôt que de trop m'inspirer de la documentation en anglais (chapitrage etc...) je pense plutôt, après une description de l'intérêt aussi claire que possible de ce nouveau dispositif, suivie d'une méthodologie de mise en oeuvre du type "recette de cuisine".
Ce n'est pas souhaitable : il faut se tenir à la structure de la documentation officielle. C'est important, justement parce qu'elle est officielle et destinée à être une référence.
Les "recettes de cuisines" ont certes tout leur intérêt, mais reflètent également un aspect subjectif des thématiques, non souhaitable dans la doc officielle. En revanche, on peut les intégrer sous la forme de liens, etc.
> Pour moi ce qui est "officiel" n'est pas forcément ma référence pédagogique.
Ben si c'est toi qui fait la doc "officielle" (ou de référence), rien n'empêche que ça le devienne.
> Je ferai donc pour moi une ressource livre (je pense...) ou un autre document que je répercuterai ici.
Plutôt le répercuter dans la doc. Comme déjà dit, c'est là la référence.
PS. Avis perso : j'avoue que j'ai du mal à comprendre cette réticence à participer à la doc de référence d'un projet libre.
D'autant que ce n'est pas en faisant les choses "dans son coin" (plutôt qu'à l'endroit officiel) que l'on peut espérer voir changer les choses durablement...
Bonjour,
"PS. Avis perso : j'avoue que j'ai du mal à comprendre cette réticence à participer à la doc de référence d'un projet libre."
Oh c'est simple.
Si je trouve que la transcription de la doc officielle n'est pas claire à mon sens, je fabrique une autre documentation pour mon besoin personnel. Et la rediffuse sans réticence dans ma communauté. Dans l'esprit du libre.
Car une explication, ou une démarche pédagogique est souvent liée à une langue qui, comme chacun le sait, n'est pas seulement un moyen de communication entre les hommes, mais aussi le véhicule d'une culture, d'un mode de pensée et de raisonnement, d'une manière de vivre.
Un anglo-saxon n'est pas un francophone. Et c'est pourquoi les langues sont si importantes à préserver. Quelles qu'elles soient.
Donc si une documentation ne me convient pas je la cuisine alors à ma propre sauce.
C'est pourquoi je fustige souvent mes amis africains de vouloir ingurgiter tels quels les concepts des occidentaux au lieu d'utiliser simplement nos outils pour produire des contenus adaptés à leur culture propre. Seule façon pour eux de "rester dignes et libres" disait quelqu'un de ce continent que j'admire beaucoup...
"Des Menschen Glück ist seine Persönlichkeit" Goethe
> Si je trouve que la transcription de la doc officielle n'est pas claire à mon sens, je fabrique une autre documentation pour mon besoin personnel [c'est moi qui souligne]
Oui, c'est bien là la question : « à mon sens » et « besoin personnel ». L'idée est en effet d'offrir une documentation qui soit claire au sens du plus grand nombre (et pas seulement au mien), et pour les besoins de tous (et pas seulement pour mes besoins personnels). C'est la raison pour laquelle j'insiste sur le côté générique des documentations.
Les autres documentations peuvent, comme déjà dit, être mises en lien. C'est même encouragé.
D'autre part, je partage ton avis sur la langue, raison pour laquelle c'est bien l'esprit du document, et non la lettre qui doit être transcrite (on ne recherche pas une traduction littérale). Et je pense que la communauté le fait très bien ! Pour le reste, je ne suis pas d'accord avec toi sur le fait que cela nécessite de re-penser à chaque fois la documentation. Mais nous nous mettrons sans doute d'accord pour constater notre désaccord sur ce point.
Bonjour Nicolas,
A propos de l'interprétation des documentations, je ne fais souvent que répercuter ce que me disent quasiment tous mes clients. Ils les trouvent trop techniques. L'essentiel étant souvent noyé dans des détails inutiles.
Et le pire c'est que j'en arrive à penser que j'ai raison, même seul contre le monde entier. Tu vois à quel stade d’orgueil j'en arrive !
Soutenu tout de même en cela par la citation de Goethe que je traduis cette fois en français: "Le bonheur de l'homme, c'est sa personnalité."
À propos de la citation de Goethe, je l'aime bien et j'aimerais savoir d'où elle est tirée. Peux-tu me renseigner ? J'ai recherché assez attentivement et n'ai trouvé nulle part de référence. Merci d'avance
Concernant la remarque que la documentation est trop technique : tu as peut-être raison, mais cela n'est pas un argument pour ne pas avoir une documentation de référence générique, et n'a donc rien à voir avec la personnalité. Par exemple, les documentations pour construire des meubles chez un fournisseur scandinave bien connu ne reflètent sans doute pas la personnalité de leur auteur. En revanche, elles ne sont pas techniques, mais au contraire tout à fait adaptées au béotien en bricolage que je suis.
Bonjour à tou(te)s,
Nous sommes déjà quelques-uns attelés à améliorer la documentation de Moodle
N'ayez pas peur de venir nous rejoindre sur le chat, et participer à améliorer la documentation !
Séverin
Bonjour Séverin,
Bonjour à tous,
J'ai divers petits soucis avec mon travail de traduction, sur la page "Utiliser Atelier". Cela concerne l'importation d'images. Sans doute pourrez-vous m'aider à les résoudre...
1/ La plupart des images mises en dépôt ne s'affichent pas. A titre d'exemple :
2/ Une image téléversée doit être supprimée du dépôt (sans la conserver dans l'historique. Est-ce possible ? Comment faire ?
Je souhaite en effet la faire disparaître, car elle possède des propriétés (méta-données) erronées, notamment un "copyright" faux, non compatible avec l'utilisation libre voulue par la licence publique générale GNU (mention "tous droits réservés"). La conception de cette image n'est d'ailleurs pas de moi, puisque je n'ai fait qu'une traduction des éléments littéraux qui y figurent.
Pas de chance par ailleurs : c'est la seule image qui s'affiche dans la page traduite (voir ci-dessus)...
Dans la liste de fichiers, il faut en fait supprimer les deux fichiers "schéma-notes-Atelier.jpg" et "schéma-notes-Atelier.svg". Je ferai ensuite une nouvelle image conforme.
Merci de votre aide,
PG
Bonjour Patrick,
je ne suis pas (loin de là) un spécialiste de l'intégration des images dans les pages de documentation.
Concernant les différents codes d'intégration :
- le premier pointe vers un fichier inexistant !
- le second pointe vers la documentation anglaise, et on ne peut pas récupérer aussi facilement les fichiers d'un autre wiki
- le dernier est effectivement correct
J'ai par contre effacé le fichier .svg ; tu peux redéposer une nouvelle version du fichier .jpg, en remplacement de celui existant.
Si l'insertion d'image te pose problème, je te suggère de regarder comment c'est fait sur d'autres pages qui comportent des images, ou de regarder la documentation mediawiki sur l'intégration d'images.
Séverin
Bonjour Séverin,
Merci pour ta réponse. Cela m'a orienté pour trouver les toutes petites erreurs que j'ai faites, et que je décris ci-dessous (avec la solution), à toutes fins utiles.
1/ "le premier pointe vers un fichier inexistant !"- Mais pourquoi Séverin écrit-il cela ? Mon fichier existe bien dans le dépôt ! La preuve, quand je veux l'importer de nouveau, j'ai le message d'attention suivant :
- En réalité, mon fichier n'existe pas en tant que "Atelier Etapes 1.jpg" , mais en tant que "Atelier_Etapes_1.jpg" ; c'est ainsi qu'il a réellement été enregistré sur le dépôt :
- Dans le code saisi sur la page de documentation, il me faut donc ne pas oublier les "underscores" lorsque j'écris le nom du fichier. Ou alors, il me faut les remplacer par des espaces lors de l'enregistrement du fichier, dans la case "Nom sous lequel le fichier sera enregistré".
- Au temps pour moi... Il me faut effectivement créer l'image "en Français", ce que je ne peux pas faire dans l'immédiat, n'ayant pas de "données de tests" sur l'activité Atelier. Ensuite bien sûr, j'aurai à enregistrer l'image dans le dépôt "français", et à faire pointer le lien de la page de documentation vers ce fichier.
Merci de ton aide,
PG
Pas besoin de créer des données test - il y a déjà un atelier avec des données sur notre site de démonstration - vous n'avez qu'à changer la langue, modifier le titre de l'atelier - et voilà
http://school.demo.moodle.net/mod/workshop/view.php?id=651&lang=fr
utilisateur: teacher -mot de passe: moodle
Merci Mary : lorsque j'ai "posté" mon dernier message, j'espérai bien en effet une telle réponse de la part d'une âme charitable,
Je n'avais pas bien cherché sur les cours du site de démonstration. Merci pour le lien vers l'activité Atelier.
Maintenant j'ai effectivement un jeu de données suffisant pour créer quelques images d'exemples. Il me restera seulement à faire les quelques traductions qui s'imposent : car si l'environnement de langue peut être traduit en Français sur le site de démonstration, il n'en reste pas moins que la plupart des cours sont en Anglais... Je suis un peu scrupuleux, et dans la Documentation en Français, je ne souhaite pas mettre une illustration sur laquelle on peu lire "Workshop : My own country", à la place de "Atelier : Douce France" !
Bien cordialement,
PG
J'utilise souvent le site si je veux faire des captures d'écran en français, parce que bien que les cours et les activités soient en anglais, on peut les modifier/supprimer comme on veut - et toutes les heures tout est 'remis à zéro'.
Bonjour,
Cela fait un moment que je voulais me mettre à la traduction de workshop/atelier, et je tombe sur cette discussion aujourd'hui (à tout hasard).
Je commencerai par traduire symboliquement un paragraphe, juste pour me lancer, pour après continuer le travail dans les semaines à venir.
Cordialement
MC
Bonjour Mario,
Le plus dur, la plupart du temps, est de se lancer la première fois. C'est plus simple ensuite, quand on comprend comment les choses fonctionnent.
Mais si chacun arrivait à prendre ne serait-ce qu'une heure par mois pour travailler sur la documentation, elle avancerait bien
Allez, il faut se lancer
Bonsoir. J'ai commencé à participer un peu à cette journée (ou pour moi, soirée) de documentaion et je me rends compte que je ne sais pas (ou plus) comment vous avez décidé de traduire les termes “nav drawer” et “gear menu”. Pour l’instant j’ai mis ’zone de navigation’ (que j'ai vue dans les sous-titres de la vidéo 3.2) et 'roue dentée’ (que je crois avoir vue quelque part) ... mais je devine
Zone de navigation est bon et me plaît bien.
Plutôt que "roue dentée", je préfère "engrenage" (légèrement plus court : 9 vs 11 caractères et un seul mot).
Super, merci - je vais continuer ce soir.
Moi aussi j'utilise toujours le terme engrenage plutôt que roue dentée.
Merci à tou(te)s les participant(e)s à la journée documentation d'hier
Même si nous n'avons pas autant avancé que l'année dernière, il y a tout de même eu des améliorations notables dans la documentation. Et j'espère que cela aura "mis le pied à l'étrier" pour quelques participants.
Dans tous les cas, il n'est jamais trop tard pour participer à l'amélioration de la documentation ; c'est un besoin et une responsabilité collective.
Séverin
Hier, j'ai malheureusement dû stopper ma participation un peu brutalement, et sans dire au revoir sur le "chat". Quand je suis revenu, il n'y avait plus personne... Donc, juste un petit mot ici pour dire merci à tous les participants, et "à bientôt" pour une autre journée d'amélioration de la documentation.
Pour ce qui est de mon travail, je compte bien le terminer "à pas trop longue échéance", surtout que Mario semble vouloir me donner un sérieux coup de main (documentation "Atelier") !
PG
Bonjour Patrick,
Je me suis dit qu'au rythme de quelques paragraphes par jour j'arriverai à compléter la traduction de l'atelier avant le MM (deux pages à traduire + FAQ).
Je n'avais pas compris qu'une deuxième personne était sur le même sujet... tant mieux. On pourra s'accorder pour adopter une page chacun peut-être ?
MC
Bonjour Mario,
Il me reste seulement quelques paragraphes à traduire dans la page "Utiliser atelier", que je pense terminer cette semaine, hormis le dernier paragraphe "Voir aussi". D'ailleurs je serais incapable de suggérer les liens vers les sites, forum, et autres discussions utiles, car à ce jour je n'ai pas assez exploré le sujet de l'activité Atelier.
Peut-être pourrais-tu te pencher sur ce dernier point ? En plus d'une bonne relecture de l'ensemble de la page (orthographe, erreurs de traduction, erreurs de compréhension ...) qui te permettra de me corriger !
Cordialement,
PG
OK Patrick,
Je fais cette partie + relecture ; de l'autre côté j'attaque la page "Paramètres d'atelier".
Cordialement
MC
Merci Mario. Ma proposition de traduction est maintenant terminée, donc soumise à relecture d'ensemble, sauf le dernier paragraphe...
Il me faudra encore faire les illustrations.
Je vous laisse avancer sur la page "Paramètres de l'atelier", que je n'avais pas vue, donc pas inscrite à mon plan de travail ! J'y jetterai un coup d’œil en relecture si vous voulez bien.
Cordialement,
PG