« STIC:Contribution Wiki » : différence entre les versions
m (→Exceptions) |
|||
Ligne 41 : | Ligne 41 : | ||
=== Exceptions === | === Exceptions === | ||
Nous définissons le terme "contribution" dans le cadre des cours STIC I et STIC II, comme étant'''toute contribution qui n'est pas formellement demandée et évaluée dans le cadre d'un autre cours du MALTT'''. Par exemple, si vous créez une fiche de lecture dans le cadre d'un autre cours où vous devez donner un feedback sur la production de vos collègues, ces contributions ne peuvent pas valoir pour STIC. Par contre, si vous modifiez une fiche d'une volée précédente ou si vous améliorez des pages du matériel du cours, y compris les pages STIC, vous pouvez comptabiliser cette participation. | Nous définissons le terme "contribution" dans le cadre des cours STIC I et STIC II, comme étant '''toute contribution qui n'est pas formellement demandée et évaluée dans le cadre d'un autre cours du MALTT'''. Par exemple, si vous créez une fiche de lecture dans le cadre d'un autre cours où vous devez donner un feedback sur la production de vos collègues, ces contributions ne peuvent pas valoir pour STIC. Par contre, si vous modifiez une fiche d'une volée précédente ou si vous améliorez des pages du matériel du cours, y compris les pages STIC, vous pouvez comptabiliser cette participation. | ||
De même, vos demandes d'aide ou de feedback pour les exercices STIC ne sont pas considérées comme des contributions. En revanche, si vous répondez à une question d'un collègue ou si vous ajoutez des détails pertinents à un échange entre un collègue et l'équipe enseignante, cela est considéré comme étant une contribution. | De même, vos demandes d'aide ou de feedback pour les exercices STIC ne sont pas considérées comme des contributions. En revanche, si vous répondez à une question d'un collègue ou si vous ajoutez des détails pertinents à un échange entre un collègue et l'équipe enseignante, cela est considéré comme étant une contribution. |
Version du 29 septembre 2018 à 16:21
Contribution Wiki obligatoire
Une contribution wiki obligatoire est demandée pour chaque période des cours STIC I et STIC II. Cette contribution est évaluée de manière cumulative pour les trois périodes, plus un critère technique/conceptuel général noté à la fin du semestre. Cet exercice est pondéré dans la moyenne finale du cours.
Cette page illustre les détails de cette contribution, à la fois d'un point de vue pratique et conceptuel.
Synthèse de la page
La page est assez détaillée, donc nous proposons une synthèse générale de référence. En résumé :
- il faut contribuer à ce Wiki ou le wiki en Anglais, de manière libre mais en dehors des livrables des autres cours MALTT et de l'intérêt personnel direct (e.g. demander de l'aide en STIC).
- les contributions doivent être reportées pour chaque période sur votre homepage sur ce Wiki et selon le même délai du dernier exercice à rendre. Vous trouvez directement un squelette de code plus bas dans cette page.
- nous allons évaluer dans un exercice à part vos contributions individuellement pour les trois périodes, plus un critère technique/conceptuel général. Chaque critère compte 1.5 points, et donc vous aurez une note sur 6 qui est pondérée avec les autres exercices du semestre pour la note finale du cours.
Objectifs de la contribution wiki
La contribution obligatoire vise à développer les compétences suivantes :
- Apprendre en écrivant. Selon la littérature "Écrire pour apprendre" (Angla. writing-to-learn), écrire est un moyen puissant pour apprendre, notamment lorsqu'il s'agit de former des vraies compétences (savoir, savoir-faire, attitudes et utilisation).
- Comprendre, d'un point de vue conceptuel, le fonctionnement de la co-construction et du partage de savoir à travers un dispositif collaboratif qui adopte une hiérarchie "éditoriale" très faible (tous les utilisateurs enregistrés peuvent en principe créer, modifier, effacer, ...)
- Produire dans un wiki
- Comprendre l'architecture de l'information "à plat" d'un Wiki, dans laquelle tout élément informatif (articles, fichiers, profil utilisateur, ...) est considéré comme une page, avec un identifiant univoque représenté par son nom/titre
- Se familiariser avec les règles et guidelines rédactionnelles d'un système partagé en termes de syntaxe, organisations des contenus, règles typographiques, ...
- Savoir maîtriser les bases d'un langage de marquage à travers un éditeur visuel et, préférablement, l'éditeur en modalité code pour évoluer à des utilisations plus avancées et à l'intégration de modèles
- Comprendre le mécanisme d'historique de versions, rétablissement d'une version précédente, différences entres versions, citation d'une version de la page à un moment donné, ...
- Connaître des fonctionnalités "accessoires" d'un Wiki, comme la possibilité d'imprimer des livres papier à partir des pages, utiliser des modèles pour créer des cours, ...
- Utiliser un wiki
- Évaluer la pertinence des contenus dans une perspective tierce et en tenant compte des utilisateurs potentiels
- Juger, de manière personnelle, de l'utilité/qualité/instrumentalité des ressources Wiki comparées à d'autres sources d'informations utilisées dans le MALTT (articles, livres, ...)
Quel type de contribution est attendu/requis
Voici de suite quelques détails plus spécifiques.
Exceptions
Nous définissons le terme "contribution" dans le cadre des cours STIC I et STIC II, comme étant toute contribution qui n'est pas formellement demandée et évaluée dans le cadre d'un autre cours du MALTT. Par exemple, si vous créez une fiche de lecture dans le cadre d'un autre cours où vous devez donner un feedback sur la production de vos collègues, ces contributions ne peuvent pas valoir pour STIC. Par contre, si vous modifiez une fiche d'une volée précédente ou si vous améliorez des pages du matériel du cours, y compris les pages STIC, vous pouvez comptabiliser cette participation.
De même, vos demandes d'aide ou de feedback pour les exercices STIC ne sont pas considérées comme des contributions. En revanche, si vous répondez à une question d'un collègue ou si vous ajoutez des détails pertinents à un échange entre un collègue et l'équipe enseignante, cela est considéré comme étant une contribution.
Modalités de participation
Vous pouvez participer au Wiki en français ou en anglais et, en dehors des exceptions citées plus haut, vous pouvez contribuer à toutes les pages disponibles, sans limitation aux sujets techniques abordés dans les exercices STIC. Vous êtes donc libres de choisir les articles sur la base de vos intérêts ou connaissances préalables.
Contribuer à un wiki ne signifie pas forcément ajouter/écrire du nouveau contenu. Votre contribution peut très bien prendre une forme différente, comme par exemple :
- Mettre en relation des pages entre elles grâce à des liens hypertextuels internes au Wiki
- Ajouter des catégories à des pages
- Contrôler que des liens externes sont encore valides et que le contenu est encore pertinent
- Ajouter des images, des schémas, des vidéos que vous créez/adaptez vous-mêmes pour mieux expliquer un passage ou une procédure
- Diviser le contenu d’une page trop chargée en créant des pages différentes
- Alléger certains blocs de texte en ajoutant des paragraphes ou des listes
- Effacer du contenu obsolète ou non pertinent à la page
- Contrôler/corriger l'orthographe (très apprécié pour améliorer la qualité perçue des pages)
- …
De plus, participer à un système partagé de connaissances n'implique pas que des aspects pratiques. Si vous n'êtes pas à l'aise avec l'idée de publier ou modifier des contenus, vous pouvez participer à travers l'onglet Discussion des pages, dans laquelle vous pouvez :
- Donner un feedback sur la qualité des contenus (soyez polis, écrire du contenu prend du temps !)
- Proposer des révisions ou des nouveaux contenus à ajouter, même si vous vous ne sentez pas de le faire vous-mêmes
- Identifier des passages, schémas, exemples, ... particulièrement outils à la compréhension d'un concept
- Vous engagez dans une discussion sur une idée ou philosophie contenue dans l'article que vous ne partagez pas ou avec laquelle vous êtes d'accord
- Confirmer que vous avez testé par exemple une section avec plusieurs liens qui pointent vers des ressources et tous sont encore valables/pertinents
- ...
En termes très pratiques, il faut nous donner la preuve qu'au moins vous lisez les pages et vous avez essayé de participer au Wiki.
Si vous avez besoin d'inspiration, il y a plein de pages
parmi lesquelles choisir. Vous pouvez également essayer une page au hasard !
Si vous voulez rester dans le domaine du cours, vous pouvez ( mais ce n'est pas une obligation) contribuer aux pages de la catégorie Ressources STIC (y compris ajouter des pages existantes mais qui ne figurent pas dans la liste).
Nouvelles pages
Si vous voulez créer une nouvelle page :
- Faites une recherche d'abord, peut-être quelque chose de similaire existe déjà
- Choisissez un titre convenable. Contrairement aux contenus, les titres des pages/fichiers sont plus problématiques à modifier. En cas de doute, demandez un avis avant de créer la page à travers l'onglet discussion de l'un des exercices STIC.
- Pensez à au moins une catégorie dans laquelle la page peut/doit figurer et ajoutez le code correspondant, i.e. [[Catégorie: nom-de-la-catégorie]]
- Créez des liens "two-ways" pour faciliter le repère de votre page :
- Depuis votre nouvelle page à d'autres pages déjà existants dans le wiki
- Depuis des pages existants à votre nouvelle page
Pour d'autres infos, voir les pages Aide:Aide et Guidelines:Règles d'édition
Reporter les contributions Wiki
Délai
Si vous effectuez/publiez vos rendus en retard, nous allons reporter la contribution sur la période suivante et nous considérons "aucune contribution" pour la période.
Modalité de rendu
Démarche à suivre :
- Créez une section avec un titre de premier niveau
== Contributions Wiki STIC ==
- Ajoutez deux sous-sections de deuxième niveau avec l’intitulé du cours
=== STIC I ===
=== STIC II ===
- À l'intérieur de chacune de ces sections, ajoutez trois sous-sections de troisième niveau avec l'intitulé de la période (P1-3 pour STIC I et P4-P6 pour STIC II).
=== P1 ===
=== P2 ===
- ...
- Enfin, ajoutez une liste des pages modifiées dans la période de référence, avec un lien interne et une description de la contribution.
La section utilisée pour les contributions peut se trouver à n'importe quel endroit dans votre page, mais elle doit figurer dans le sommaire.
Squelette à ajouter à votre page
== Contributions Wiki STIC == === STIC I === ==== P1 ==== * [[JavaScript]] : corrections d’orthographe, ajout de lien * [[Autonomie]] : ouvert une discussion sur les bénéfices de l'autonomie dans l'apprentissage à distance ==== P2 ==== Aucune contribution dans cette période ==== P3 ==== * Contributions minimalistes/corrections des pages [[Node.js]], [[Interactivité avec JavaScript]] et [[Introduction à la programmation]] === STIC II === ==== P4 ==== * ... ==== P5 ==== * ... ==== P6 ==== * ...
Dans la section suivante, vous trouvez le rendu de ce code.
Contributions Wiki STIC (exemple de rendu)
STIC I
P1
- JavaScript : corrections d’orthographe, ajout de lien
- Autonomie : ouvert une discussion sur les bénéfices de l'autonomie dans l'apprentissage à distance
P2
Aucune contribution dans cette période
P3
- Contributions minimalistes/corrections des pages Node.js, Interactivité avec JavaScript et Introduction à la programmation
STIC II
P4
- ...
P5
- ...
P6
- ...
Critères d'évaluation
La grille d'évaluation de l'exercice "contribution wiki" se compose de la manière suivante :
- 3 critères à 1.5 points chacun en correspondance des contributions pour les périodes P1, P2 et P3 (STIC I) et P4, P5 et P6 (STIC II)
- 1 critère général, évalué à la fin du semestre, qui porte sur la qualité technique/conceptuelle de la participation
Voir la grille d'évaluation complète - disponible également dans l'espace Moodle du cours :
Conseils
En général
Voici quelques conseils généraux pour vos contributions :
- Faites attentions aux droits d'auteur : en général tout contenu disponible sur internet est couvert par un copyright ! Citer la source n'est souvent pas suffisant. Réfléchissez et informez-vous bien avant de faire du copier/coller ou importer un fichier.
- Soyez curieux et regardez le code des pages bien faites, intéressantes, etc.
- Planifiez des objectifs atteignables en termes de temps et ressources. Par exemple, on sous-estime la quantité de travail pour créer une nouvelle page et la rédiger de manière correcte.
- Vous pouvez modifier à chaque période la même page de manière progressive, mais on vous conseille plutôt de contribuer à plusieurs pages.
- Si vous faîtes un exercice STIC (e.g. petit dispositif d'apprentissage, tutoriel vidéo, ...) qui peut être en relation avec l'une des pages du wiki, ajoutez-le, par exemple dans les sections "Liens" ou "Ressources" qui se trouvent souvent au fond des pages
- Si personne ne répond à une discussion que vous avez ouverte sur une page spécifique, mettez une annonce dans la discussion de l'une des pages des exercices pour la période, ce sera plus visible
- Considérez que l'équipe enseignante n'est pas compétente sur tous les contenus du wiki, donc ne prenez pas mal si on est plus interactifs sur des pages techniques ou dont nous sommes les auteurs ou contributeurs majeurs. Tout contenu cohérent avec ce wiki nous intéresse !
- Vous êtes ici pour apprendre, lancez-vous : il y a toujours la version des historiques pour récupérer du contenu. En même temps, si vous faites des erreurs dans la syntaxe qui empêchent l'affichage du contenu, mettez une annonce dans la page de discussion de l'un des exercices pour qu'on puisse le réparer
Pages/Tutoriel techniques
Plus en particulier, pour créer ou contribuer à de la documentation technique ou créer des tutoriels, penser à :
- Pour du code, utilisez la balise
source
(ou l'équivalentsyntaxhighlight
) pour faciliter la coloration syntaxique sur la base du langage, e.g. :- <source lang="HTML5">...</source>
<div class="highlight">Hello world!</div>
- <source lang="CSS" line>...</source> pour ajouter le nombre des lignes
div { color: #003366; }
- <source lang="JavaScript" line highlight="2,3">...</source> pour mettre en évidence des passages particuliers
//Comment not highlighted var message = "Hello world highlighted"; //Comment highlighted var another = "Message not highlighted";
- <source lang="HTML5">...</source>
- Pour des tutoriels sur des logiciels :
- Prévoyez une section pour l'installation mais spécifiez seulement des informations particulières qu'on ne trouve pas facilement sur le site officiel ou qui sont particulières à un système d'exploitation (e.g. pour Mac il faut installer également... ou cela ne marche pas sous Windows, etc.), ce n'est pas utile d'avoir des captures d'écran de chaque passage
- Référez à quelle version du logiciel vous faites référence (voir Versionnage sémantique)
- Dans l'introduction, illustrez si possible des cadres d'utilisation avec finalités cohérentes avec ce wiki pour donner aux lecteurs une idée de pourquoi cela pourrait les concerner/intéresser
- Lisez d'abord des bons tutoriels ou pages techniques sur ce wiki et essayez de reproduire les concepts et les informations que vous trouvez utiles