« STIC:Contribution Wiki » : différence entre les versions
mAucun résumé des modifications |
|||
(12 versions intermédiaires par 4 utilisateurs non affichées) | |||
Ligne 12 : | Ligne 12 : | ||
'''En résumé''' : | '''En résumé''' : | ||
* il faut contribuer à ce Wiki ou | * 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) | * 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 | * vous indiquez avec un lien dans une squelette donnée plus bas quelle page correspond à la modalité de contribution proposée | ||
Ligne 18 : | Ligne 18 : | ||
* 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 | * 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 | * 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 | * 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 : | Pour les modalités de participation à ce wki, voir : | ||
Ligne 31 : | 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]]" ( | # '''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, | #* 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 | #* 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 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é, | #* 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é == | == Déroulement de l'activité == | ||
L'activité propose | 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 === | === Types de modalités possibles === | ||
Ligne 52 : | Ligne 52 : | ||
* Corrections orthographiques : '''0.25''' | * Corrections orthographiques : '''0.25''' | ||
* Améliorations textuelle d'une partie existante d'une page : '''0. | * Améliorations textuelle d'une partie existante d'une page : '''0.50''' | ||
* Utilisation d'un modèle: '''0. | * Utilisation d'un modèle: '''0.50''' | ||
* Ajout de liens internes et/ou catégories: '''0.75''' | * Ajout de liens internes et/ou catégories: '''0.75''' | ||
* Introduction d'une brève partie dans une page existante: '''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''' | * Création d'une page pertinente, mais avec peu de contenu: '''1.00''' | ||
* Introduction d'une partie importante dans une page existante: '''1.25''' | * Introduction d'une partie importante dans une page existante: '''1.25''' | ||
* Relecture complète d'un article avec indication dans la discussion: '''1. | * Relecture complète d'un article avec indication dans la discussion: '''1.50''' | ||
* Re-organisation pertinente du wiki (catégories, | * 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''' | * 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''' | * Ouverture et/ou participation à la discussion sur le contenu d'un article: '''1.75''' | ||
* Réorganisation importante d'un article: '''2.00''' | * Réorganisation importante d'un article: '''2.00''' | ||
* Création d'une nouvelle page pertinente avec contenu conséquent: '''2.50''' | * Création d'une nouvelle page pertinente avec contenu conséquent: '''2.50''' | ||
* Création d'une | * Création ou refonte d'une page existante de haute qualité au niveau technique et au niveau des contenus: '''5.00''' | ||
}} | }} | ||
Ligne 74 : | Ligne 74 : | ||
# Vous indiquez la page dans laquelle vous avez effectué le type de modification depuis la liste | # 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 | # L'équipe enseignante contrôle que la page présente effectivement ce type de modification | ||
# Si l'équipe enseignante valide le type de modification, | # Si l'équipe enseignante valide le type de modification, les points sont ajoutés au total | ||
# La somme des | # La somme des points est plafonnée à 6 | ||
# La note finale | # La note finale obtenue est ajoutée aux autres exercices STIC pour faire une moyenne pondérée | ||
=== Exceptions === | === Exceptions === | ||
Ligne 105 : | 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 111 : | 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, | * 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 | * 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 132 : | Ligne 125 : | ||
# '''Faites une recherche d'abord''', peut-être que 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 | # 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 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 178 : | Ligne 171 : | ||
* Réorganisation importante d'un article (2.00) : | * Réorganisation importante d'un article (2.00) : | ||
* Création d'une nouvelle page pertinente avec contenu conséquent (2.50) : | * Création d'une nouvelle page pertinente avec contenu conséquent (2.50) : | ||
* Création d'une | * Création ou refonde d'une page existante de haute qualité au niveau technique et des contenus (5.00) : | ||
</nowiki> | </nowiki> | ||
</pre> | </pre> | ||
Ligne 192 : | Ligne 185 : | ||
* 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, | * 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 199 : | Ligne 192 : | ||
=== Pages/Tutoriel techniques === | === Pages/Tutoriel techniques === | ||
Plus | 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>syntaxhighlight</code> pour faciliter la coloration syntaxique sur la base du langage, | * Pour du code, utilisez la balise <code>syntaxhighlight</code> pour faciliter la coloration syntaxique sur la base du langage, par exemple : | ||
** <nowiki><syntaxhighlight lang="HTML5">...</syntaxhighlight></nowiki> | ** <nowiki><syntaxhighlight lang="HTML5">...</syntaxhighlight></nowiki> | ||
**: <syntaxhighlight lang="HTML"><div class="highlight">Hello world!</div></syntaxhighlight> | **: <syntaxhighlight lang="HTML"><div class="highlight">Hello world!</div></syntaxhighlight> | ||
Ligne 218 : | Ligne 211 : | ||
*: | *: | ||
* 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 ( | ** 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 | ** 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
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 :
- 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).
- 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
- 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.
- 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 :
- 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
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 :
- Faites une recherche d'abord, peut-être que quelque chose de similaire existe déjà.
- 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. [[Catégorie: nom-de-la-catégorie]]
- 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
Démarche à suivre :
- Créez une section avec un titre de premier niveau
== Contributions Wiki STIC ==
- 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";
- <syntaxhighlight lang="HTML5">...</syntaxhighlight>
- 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