STIC:Contribution Wiki

Cette page fait partie des cours STIC I et STIC II

STIC

Archives STIC

Chantier STIC

Initiation à la pensée computationnelle avec JavaScript

Productions STIC

Ressources STIC

STIC:Contribution Wiki

STIC:Rapport STIC I et II

STIC:STIC I (Edda)

STIC:STIC I - Atelier technique 2

STIC:STIC I - exercice 1 (Drakkar)

STIC:STIC I - exercice 1 (Edda)

STIC:STIC I - exercice 2 (Edda)

STIC:STIC I - exercice 3 (Edda)

STIC:STIC I - exercice 4 (Edda)

STIC:STIC I - exercice 5 (Edda)

STIC:STIC I - exercice 6 (Edda)

STIC:STIC III

STIC:STIC III (2022)

STIC:STIC III (2022)/Exploration des Problématiques Liées aux Ponts et Détails

STIC:STIC IV

Contribution Wiki obligatoire

Une participation à ce wiki est demandée et évaluée dans le cadre du cours STIC:STIC I. 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 l'EduTech Wiki 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).
• il existe différentes modalités de contribuer au wiki, chacune avec un coefficient de points selon la difficulté et l'effort nécessaire (e.g. corrections orthographiques 0.25 ... article de haute qualité 5.00)
• vous indiquez avec un lien dans une squelette donnée plus bas quelle page correspond à la modalité de contribution proposée
• une page peut figurer seulement dans une seule modalité de contribution, il n'est pas possible de faire figurer la même page à plusieurs endroits, même si la page propose plusieurs types de contributions à la fois
• la note de l'activité est calculée avec la somme des coefficients des pages qui auront été validées comme adéquates pour la modalité de contribution correspondante
• il n'est pas obligatoire, ni nécessaire de faire tous les types de contributions, on peut arriver à 4 ou même à 6 avec seulement une partie des modalités envisagées
• la note de l'activité est enfin pondérée avec les autres exercices STIC I pour déterminer la note finale du cours

Pour les modalités de participation à ce wki, voir :

• Guidelines:Règles d'édition
• Guideline editoriel
• Guidelines:Edition de base
• Guidelines:Edition avancée

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" (Anglais 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, etc.)
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, etc.) 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, etc.
   • 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 vers des utilisations plus avancées et à l'intégration de modèles
   • Comprendre le mécanisme appelé historique/gestion de versions, rétablissement d'une version précédente, différences entres versions, citation d'une version de la page à un moment donné, etc.
   • 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, etc.
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, etc.)

Déroulement de l'activité

L'activité propose différentes modalités de contributions qui sont toutes utiles dans un wiki. Chaque modalité dispose d'un nombre de points proportionnel à la difficulté et/ou à l'effort pour effectuer ce type de contribution. Vous pouvez gagner les points si vous avez une page unique dans laquelle vous avez effectué la modalité de contribution.

Types de modalités possibles

• Corrections orthographiques : 0.25
• Améliorations textuelle d'une partie existante d'une page : 0.50
• Utilisation d'un modèle: 0.50
• Ajout de liens internes et/ou catégories: 0.75
• Introduction d'une brève partie dans une page existante: 0.75
• Création d'une page pertinente, mais avec peu de contenu: 1.00
• Introduction d'une partie importante dans une page existante: 1.25
• Relecture complète d'un article avec indication dans la discussion: 1.50
• Re-organisation pertinente du wiki (catégories, etc.) : 1.50
• Amélioration technique d'une partie d'un article (utilisation d'un modèle, ajout d'une image/schéma saillant) : 1.50
• Ouverture et/ou participation à la discussion sur le contenu d'un article: 1.75
• Réorganisation importante d'un article: 2.00
• Création d'une nouvelle page pertinente avec contenu conséquent: 2.50
• Création ou refonte d'une page existante de haute qualité au niveau technique et au niveau des contenus: 5.00

Modalité d'évaluation

L'évaluation est faite de la manière suivante :

1. Vous indiquez la page dans laquelle vous avez effectué le type de modification depuis la liste
2. L'équipe enseignante contrôle que la page présente effectivement ce type de modification
3. Si l'équipe enseignante valide le type de modification, les points sont ajoutés au total
4. La somme des points est plafonnée à 6
5. La note finale obtenue est ajoutée aux autres exercices STIC pour faire une moyenne pondérée

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)
• Etc.

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, etc. particulièrement utiles à la compréhension d'un concept
• Vous engager 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 exemple :

• Incomplètes
• En construction

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 que quelque chose de similaire existe déjà.
2. Choisissez un titre convenable. Notamment, ne jamais mettre un titre provisoire ! 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 bidirectionnels pour faciliter l'accès à votre page :
   • Depuis votre nouvelle page à d'autres pages déjà existantes 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

Vos contributions doivent figurer sur votre page profil EduTechWiki en français pour le dernier délai du cours. Mais vous pouvez contribuer à tout moment pendant le semestre.

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. Inserez une liste à puce avec les modalités de contribution que vous avez effectuée et le lien interne à la page dans laquelle la page a été effectuée, par exemple :

   * Corrections orthographiques (0.25) : [[Introduction à la programmation]]

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 ==

* Corrections orthographiques (0.25) :
* Améliorations textuelle d'une partie existante d'une page (0.5) :
* Utilisation d'un modèle (0.5) :
* Ajout de liens internes et/ou catégories (0.75) :
* Introduction d'une brève partie dans une page existante (0.75) :
* Création d'une page pertinente, mais avec peu de contenu (1.00) :
* Introduction d'une partie importante dans une page existante (1.25) :
* Relecture complète d'un article avec indication dans la discussion (1.5) :
* Re-organisation pertinente du wiki (catégories, ...) (1.50) :
* Amélioration technique d'une partie d'un article (utilisation d'un modèle, ajout d'une image/schéma saillant) (1.50) :
* Ouverture et/ou participation à la discussion sur le contenu d'un article (1.75) :
* Réorganisation importante d'un article (2.00) :
* Création d'une nouvelle page pertinente avec contenu conséquent (2.50) :
* Création ou refonde d'une page existante de haute qualité au niveau technique et des contenus (5.00) :

Conseils

En général

Voici quelques conseils généraux pour vos contributions :

• Faites attention 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, etc.) 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 particulièrement, pour créer ou contribuer à de la documentation technique ou créer des tutoriels, pensez à :

• Pour du code, utilisez la balise syntaxhighlight pour faciliter la coloration syntaxique sur la base du langage, par exemple :
  • <syntaxhighlight lang="HTML5">...</syntaxhighlight>

    <div class="highlight">Hello world!</div>
    

  • <syntaxhighlight lang="CSS" line>...</syntaxhighlight> pour ajouter le nombre des lignes

        div { 
          color: #003366; 
        }
    

  • <syntaxhighlight lang="JavaScript" line highlight="2,3">...</syntaxhighlight> 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 (par exemple: "pour Mac il faut installer également..." ou "cela ne marche pas sous Windows", etc.). Il n'est pas nécessaire d'avoir des captures d'écran de chaque étape
  • Mentionnez 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