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

De EduTech Wiki
Aller à la navigation Aller à la recherche
 
(48 versions intermédiaires par 8 utilisateurs non affichées)
Ligne 5 : Ligne 5 :
== Contribution Wiki obligatoire ==
== Contribution Wiki obligatoire ==


Une contribution wiki obligatoire est demandée pour chaque période des cours [[STIC:STIC I|STIC I]] et [[STIC:STIC II|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.  
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.


Cette page illustre les détails de cette contribution, à la fois d'un point de vue pratique et conceptuel.
=== Synthèse de la page ===


=== 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'[[:en:Main Page|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


La page est assez détaillée, donc nous proposons une synthèse générale de référence. '''En résumé''' :
Pour les modalités de participation à ce wki, voir :


* il faut contribuer à ce Wiki ou le [[:en:Main Page|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).
* {{ Goblock | [[Guidelines:Règles d'édition]] }}
* 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.
* {{ Goblock | [[Guideline editoriel]] }}
* 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.
* {{ Goblock | [[Guidelines:Edition de base]] }}
* {{ Goblock | [[Guidelines:Edition avancée]] }}


== Objectifs de la contribution wiki ==
== Objectifs de la contribution wiki ==
Ligne 21 : Ligne 31 :
La contribution obligatoire vise à développer les compétences suivantes :
La contribution obligatoire vise à développer les compétences suivantes :


# '''Apprendre en écrivant'''. Selon la littérature "[[Écrire pour apprendre]]" (Angla. [[:en:writing-to-learn|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).
# '''Apprendre en écrivant'''. Selon la littérature "[[Écrire pour apprendre]]" (Anglais [[:en:writing-to-learn|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, ...)
# 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.)
# '''Produire dans un wiki'''
# '''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
#* 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 [[Guidelines:Règles d'édition|'''règles''']] et [[Guideline editoriel|'''guidelines rédactionnelles''']] d'un système partagé en termes de syntaxe, organisations des contenus, règles typographiques, ...
#* Se familiariser avec les [[Guidelines:Règles d'édition|'''règles''']] et [[Guideline editoriel|'''guidelines rédactionnelles''']] d'un système partagé en termes de syntaxe, organisations des contenus, règles typographiques, etc.
#* Savoir maîtriser '''[[Guidelines:Edition_de_base|les bases d'un langage de marquage]]''' à travers un éditeur visuel et, préférablement, l'éditeur en modalité code pour évoluer à des [[Guidelines:Edition avancée|'''utilisations plus avancées''']] et à l'[[Page de démo de modèles|'''intégration de modèles''']]
#* Savoir maîtriser '''[[Guidelines:Edition_de_base|les bases d'un langage de marquage]]''' à travers un éditeur visuel et, préférablement, l'éditeur en modalité code pour évoluer vers des [[Guidelines:Edition avancée|'''utilisations plus avancées''']] et à l'[[Page de démo de modèles|'''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é, ...
#* Comprendre le mécanisme appelé '''[[gestion de versions|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'[[Impression à la demande de Pediapress|imprimer des livres papier à partir des pages]], utiliser des modèles pour créer des cours, ...
#* Connaître des '''fonctionnalités "accessoires" d'un Wiki''', comme la possibilité d'[[Impression à la demande de Pediapress|imprimer des livres papier à partir des pages]], utiliser des modèles pour créer des cours, etc.
# '''Utiliser un wiki'''
# '''Utiliser un wiki'''
#* Évaluer la '''pertinence des contenus''' dans une perspective tierce et en tenant compte des utilisateurs potentiels
#* É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, ...)
#* 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 ===
 
{{ bloc important |
 
* 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'''
 
}}


== Quel type de contribution est attendu/requis ==
=== Modalité d'évaluation ===


{{bloc important | 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. }}
L'évaluation est faite de la manière suivante :


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


=== Exceptions ===
=== Exceptions ===
Ligne 59 : Ligne 98 :
* Effacer du contenu obsolète ou non pertinent à la page
* 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)
* 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 :
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 :
Ligne 65 : Ligne 104 :
* Donner un feedback sur la qualité des contenus (soyez polis, écrire du contenu prend du temps !)
* 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
* 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
* Identifier des passages, schémas, exemples, etc. particulièrement utiles à 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
* 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
* Confirmer que vous avez testé par exemple une section avec plusieurs liens qui pointent vers des ressources et tous sont encore valables/pertinents
* ...
* ...
Ligne 85 : Ligne 124 :
Si vous voulez créer une nouvelle page :
Si vous voulez créer une nouvelle page :


# '''Faites une recherche d'abord''', peut-être quelque chose de similaire existe déjà
# '''Faites une recherche d'abord''', peut-être que 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.
# 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.
# Pensez à au moins une catégorie dans laquelle la page peut/doit figurer et ajoutez le code correspondant, i.e. <nowiki>[[Catégorie: nom-de-la-catégorie]]</nowiki>
# Pensez à au moins une catégorie dans laquelle la page peut/doit figurer et ajoutez le code correspondant, i.e. <nowiki>[[Catégorie: nom-de-la-catégorie]]</nowiki>
# Créez des liens "two-ways" pour faciliter le repère de votre page :
# Créez des liens bidirectionnels pour faciliter l'accès à votre page :
#* Depuis votre nouvelle page à d'autres pages déjà existants dans le wiki
#* Depuis votre nouvelle page à d'autres pages déjà existantes dans le wiki
#* Depuis des pages existants à votre nouvelle page
#* Depuis des pages existants à votre nouvelle page


Ligne 98 : Ligne 137 :
=== Délai ===
=== Délai ===


{{bloc important | Le délai pour les contributions à faire dans chaque période est le même du '''dernier''' exercice à rendre. }}
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.
 
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 ===
=== Modalité de rendu ===
Ligne 110 : Ligne 147 :
# Créez une section avec un titre de premier niveau  
# Créez une section avec un titre de premier niveau  
#: <code><nowiki>== Contributions Wiki STIC ==</nowiki></code>
#: <code><nowiki>== Contributions Wiki STIC ==</nowiki></code>
# Ajoutez deux sous-sections de deuxième niveau avec l’intitulé du cours
# 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 :
#: <code><nowiki> === STIC I ===</nowiki></code>
#: <code><nowiki>* Corrections orthographiques (0.25) : [[Introduction à la programmation]]</nowiki></code>
#: <code><nowiki> === STIC II ===</nowiki></code>
# À 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).
#: <code><nowiki> === P1 ===</nowiki></code>
#: <code><nowiki>=== P2 ===</nowiki></code>
#: ...
# 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.
La section utilisée pour les contributions peut se trouver à n'importe quel endroit dans votre page, mais elle doit figurer dans le sommaire.
Ligne 126 : Ligne 157 :
<nowiki>
<nowiki>
== Contributions Wiki STIC ==
== 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 ===
* Corrections orthographiques (0.25) :
==== P4 ====
* Améliorations textuelle d'une partie existante d'une page (0.5) :
* ...
* Utilisation d'un modèle (0.5) :
==== P5 ====
* Ajout de liens internes et/ou catégories (0.75) :
* ...
* Introduction d'une brève partie dans une page existante (0.75) :
==== P6 ====
* 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) :
</nowiki>
</nowiki>
</pre>
</pre>
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 ====
* 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 :
[[Fichier:STIC grille évaluation contribution wiki.png|800px|vignette|néant|Grille d'évaluation pour les contributions wiki liées au cours STIC I et II]]


== Conseils ==
== Conseils ==
Ligne 182 : Ligne 181 :
Voici quelques conseils généraux pour vos contributions :
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.
* '''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.
* 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.
* 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.
* 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 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
* 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 !
* 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 !
Ligne 193 : Ligne 192 :
=== Pages/Tutoriel techniques ===
=== Pages/Tutoriel techniques ===


Plus en particulier, pour créer ou contribuer à de la documentation technique ou créer des tutoriels, penser à :
Plus particulièrement, pour créer ou contribuer à de la documentation technique ou créer des tutoriels, pensez à :


* Pour du code, utilisez la balise <code>source</code> (ou l'équivalent <code>syntaxhighlight</code>) pour faciliter la coloration syntaxique sur la base du langage, e.g. :
* Pour du code, utilisez la balise <code>syntaxhighlight</code> pour faciliter la coloration syntaxique sur la base du langage, par exemple :
** <nowiki><source lang="HTML5">...</source></nowiki>
** <nowiki><syntaxhighlight lang="HTML5">...</syntaxhighlight></nowiki>
**: <source lang="HTML"><div class="highlight">Hello world!</div></source>
**: <syntaxhighlight lang="HTML"><div class="highlight">Hello world!</div></syntaxhighlight>
** <nowiki><source lang="CSS" line>...</source></nowiki> pour ajouter le nombre des lignes
** <nowiki><syntaxhighlight lang="CSS" line>...</syntaxhighlight></nowiki> pour ajouter le nombre des lignes
**: <source lang="CSS" line="">
**: <syntaxhighlight lang="CSS" line="">
     div {  
     div {  
       color: #003366;  
       color: #003366;  
     }</source>
     }</syntaxhighlight>
** <nowiki><source lang="JavaScript" line highlight="2,3">...</source></nowiki> pour mettre en évidence des passages particuliers
** <nowiki><syntaxhighlight lang="JavaScript" line highlight="2,3">...</syntaxhighlight></nowiki> pour mettre en évidence des passages particuliers
**: <source lang="JavaScript" line="" highlight="2,3">
**: <syntaxhighlight lang="JavaScript" line="" highlight="2,3">
     //Comment not highlighted
     //Comment not highlighted
     var message = "Hello world highlighted";
     var message = "Hello world highlighted";
     //Comment highlighted
     //Comment highlighted
     var another = "Message not highlighted";
     var another = "Message not highlighted";
     </source>
     </syntaxhighlight>
*:
*:
* Pour des tutoriels sur des logiciels :
* 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
** 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
** Référez à quelle '''version du logiciel''' vous faites référence (voir [[Versionnage sémantique]])
** 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
** 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
** 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

Dernière version du 26 septembre 2024 à 14:43

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 :

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 :

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
Récupérée de « https://edutechwiki.unige.ch/fmediawiki/index.php?title=STIC:Contribution_Wiki&oldid=179760 »