« STIC:Contribution Wiki » : différence entre les versions

De EduTech Wiki
Aller à la navigation Aller à la recherche
(Syntaxe et structure du contenu)
Ligne 72 : Ligne 72 :
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.
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 énormément de pages parmi lesquelles choisir.
Si vous avez besoin d'inspiration, il y a énormément de pages parmi lesquelles choisir, par exemples :


* [[:Catégorie:Incomplet | Incomplètes]]
* [[:Catégorie:Incomplet | Incomplètes]]

Version du 5 décembre 2018 à 12:46

Cette page fait partie des cours STIC I et STIC II

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 :

  1. 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).
  2. 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, ...)
  3. 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, ...
  4. 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

Toute forme de participation qui contribue à l'expansion, maintien et/ou adaptation d'un système partagé de connaissances, en rapport avec les technologies éducatives au sens large, est considérée comme une contribution valable.

Voici de suite quelques détails plus spécifiques.

Exceptions

Dans le cadre des cours STIC I et STIC II, nous considérons le terme "contribution" 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 énormément de pages parmi lesquelles choisir, par exemples :

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 :

  1. Faites une recherche d'abord, peut-être quelque chose de similaire existe déjà
  2. 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.
  3. 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]]
  4. 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

Le délai pour les contributions à faire dans chaque période est le même du dernier exercice à rendre.

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

Vous devez lister vos contributions dans votre page personelle sur EduTechWiki français, que ce soit pour des contributions en anglais ou en français.

Démarche à suivre :

  1. Créez une section avec un titre de premier niveau
    == Contributions Wiki STIC ==
  2. Ajoutez deux sous-sections de deuxième niveau avec l’intitulé du cours
    === STIC I ===
    === STIC II ===
  3. À 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 ===
    ...
  4. 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 : ouverture d'une discussion sur les bénéfices de l'autonomie dans l'apprentissage à distance

P2

Aucune contribution dans cette période

P3

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 :

Grille d'évaluation pour les contributions wiki liées au cours STIC I et II

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'équivalent syntaxhighlight) 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";
      
  • 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