STIC:Rapport STIC I et II
Rédaction d’un rapport pour STIC I et II
La rédaction d’un rapport qui accompagne chaque exercice des cours STIC I et II est une activité obligatoire et l’évaluation du rapport représente l’un des critères de la grille d’évaluation.
Cette page vous présente quelques éléments pour rédiger un rapport qui respecte les consignes et qui, en même temps, peut représenter un exercice outil au niveau pédagogique.
Emplacement du rapport
Le nom du fichier de votre rapport doit être :
- index.html ou
- welcome.html
Il doit être mis sur le serveur TECFA tecfaetu.unige.ch à un endroit précis.
- Pour STIC I
/web/etu-maltt/promotion/votre-login-court/stic-1/exN/
- Pour STIC II
/web/etu-maltt/promotion/votre-login-court/stic-2/exN/
Remplacez les parties en italique avec les éléments appropriés.
Attention : on s’attend exactement à ce type de chemin, donc
- stic-1 et non pas stic1, stic-i, ou STIC-1
- ex1, ex2, … ex10 et non pas exercice1, exe1, Ex01
Structure du rapport
Le rapport doit être une page HTML5 dans laquelle les informations suivantes doivent être facilement repérables :
- Votre nom et prénom
- Le numéro de l’exercice
- La date
Votre nom et le numéro de l’exercice doivent figurer également dans la balise title du document HTML5.
Le rapport peut être écrit en français ou en anglais. Nous ne regardons pas les petites fautes, mais rappelez-vous que c’est un rendu de niveau Master ! Relisez le rapport au moins une fois avant de le publier.
Le contenu de votre rapport doit être divisé en sections. Chaque section doit avoir un titre (i.e. une balise de type h1 ou h2). Chaque section peut être divisée ultérieurement en sous-sections si vous le souhaitez (e.g. si l'exercice prévoit plusieurs productions), mais en tout cas les sections suivantes doivent figurer dans cet ordre :
- Liens
- Objectifs
- Design
- Production
- Auto-évaluation
- Bibliographie
- Ressources
- Contribution Wiki
SVP, créez les sections même si vous n’avez pas de contenu. Par exemple, créez quand même la section « Bibliographie » ou « Ressources » et insérez une phrase du style « aucune ressource utilisée pour cet exercice ».
Liens
Vous devez placer à cet endroit les liens hypertextuels aux résultats/rendus attendus pour l’exercice. Dans la plupart des cas cela correspond à l’un ou plusieurs des éléments suivants :
- Une page avec votre dispositif/application.
- Sauf indication contraire dans les consignes de l’exercice, vous pouvez choisir où déposer vos fichiers. Seulement l’emplacement du rapport est réglementé.
- Une bonne pratique est de créer un sous-répertoire dans le dossier de votre rapport (e.g. …/stic-1/ex2/app/, ou …/stic-1/ex2/animation-cycle-eau/)
- Des fichiers qui composent ou accompagnent votre dispositif (e.g. lien à une feuille de style, …)
- Un fichier .zip qui contient plusieurs éléments
Évitez des paths et noms des fichiers qui contiennent des accents, des espaces ou caractères spéciaux (à exception de - ou _) et utilisez seulement les minuscules. Les liens doivent être :
- corrects : testez-les !!
- bien identifiables (i.e. on doit voir que c’est un lien et non pas un titre ou du texte)
- labellisés de manière explicative : évitez des liens du style « ex 2 », mais décrivez ce à quoi l'on peut s’attendre en cliquant sur le lien (e.g. « Animation sur le cycle de l’eau », « Download du fichier .zip », etc.).
Objectifs
Vous devez décrire dans cette section les objectifs de votre dispositif/application, en indiquant par exemple :
- à quoi ça sert ?
- quel est le publique cible ? qui va l’utiliser ?
- dans quel cadre ? (e.g. accompagnement dans un cours en présentiel, libre accès sur internet, etc.)
- quelles sont les connaissances préalables nécessaires pour l’utiliser ?
- quelles sont les connaissances que les utilisateurs sont censés obtenir après l’utilisation ?
- etc.
Attention : dans les objectifs vous NE DEVEZ PAS décrire vos objectifs personnels d’apprentissage. Évitez donc des formules style « l’objectif de cet exercice est de se familiariser avec HTML5 ». Imaginez de présenter votre dispositif à quelqu’un d’autre qui ne le connait pas du tout, et, surtout, qui ne l’a pas encore vu. Nous allons lire vos rapports AVANT de voir vos dispositifs.
Design
Dans cette section vous devez fournir des informations à propos du design à la fois au niveau pédagogique et de l’interface. En d’autres termes, vous devez décrire brièvement les interactions principales et/ou l’agencement des contenus qui sont disponibles et pourquoi ceux-ci favorisent l’apprentissage, facilitent une tâche, etc. Essayez de vous mettre dans la peau de l’utilisateur : cette perspective vous permettra également de voir des points faibles ou des problèmes dans votre design. Comme pour les objectifs, nous allons lire votre description du design AVANT de voir votre dispositif, donc on devrait déjà pouvoir se faire une idée du résultat.
Production
Décrivez très brièvement les passages nécessaires pour développer votre dispositif/application. Insérez juste les étapes fondamentales, il ne faut pas entrer dans les détails. Vous pouvez également parler à cet endroit de quelque passage qui vous a posé des problèmes et pour lequel vous avez trouvé une solution qui puisse être utile aux autres.
Auto-évaluation
Analysez votre résultat de manière critique : quel sont les points forts ? Quels sont les limites ? Qu’est-ce qu’on pourrait améliorer ? Etc. Vous pouvez également parler à cet endroit de votre ressenti vis-à-vis de l’exercice (difficultés, discussion des technologies/techniques utilisées, etc.).
Bibliographie
Citez les références qui vous ont aidées pour créer votre dispositif. Les références peuvent être de type théorique (e.g. articles scientifiques, liens avec d’autres cours du MALTT) ou technique (tutoriels en ligne, etc.). Vous ne devez pas forcément respecter les normes APA, même si c’est un bon exercice de le faire. Vous n’êtes pas obligés non plus de citer les ressources EduTechWiki qui sont proposées pour chaque exercice.
Ressources
Toutes les ressources externes utilisées dans votre exercice doivent être citées (e.g. images, vidéos, textes tirés de Wikipédia, …). Faites attention à ce que vous ayez bien le droit d’utiliser ces ressources (i.e. contrôler le type de licence). En règle générale, toute ressource disponible sur internet ne peut pas être utilisée à moins qu’il y ait une référence explicite à l’usage. Voir Licences Creative Commons et Copyleft. Il est bien de citer les ressources externes également dans la page de votre dispositif/application. Si vous avez créé vous-mêmes des ressources, vous pouvez spécifier des conditions de réutilisation.
Contribution Wiki
À propos de la contribution Wiki
L’activité Wiki est associée à chaque exercice au niveau de l’évaluation, mais votre contribution peut porter sur l’ensemble du Wiki. Vous pouvez contribuer au Wiki en français ou en anglais. 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
- …
Si vous avez besoin d'inspiration, il y a plein de pages
parmi lesquelles choisir. Vous pouvez également essayer une page au hasard !
Si vous voulez rester dans le domaine du cours, vous pouvez ( mais ne devez pas !) contribuer aux pages de la catégorie Ressources STIC (y compris ajouter des pages existants mais qui ne figurent pas dans la liste).
Nouvelles pages
Si vous voulez créer une nouvelle page
- Faites une recherche d'abord, peut-être quelque chose de similaire existe déjà
- Pensez à au moins une catégorie dans laquelle la page peut/doit figurer et ajoutez le code correspondant, i.e. [[Catégorie: nom-de-la-catégorie]]
- Créez des liens "two-ways"
- 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 dans votre rapport
Dans la section consacrée aux contributions, vous devez illustrer la/les contribution(s) wiki que vous avez faites pour cet exercice. Vous devez lister chaque page que vous avez modifiée et fournir une brève description de ce que vous avez fait. Par exemple :
- Page JavaScript : petites corrections d’orthographe, ajoute d’un lien avec un tutoriel
- Page HTML5 : création d’une section sur la géolocalisation
- Ajouté la catégorie X aux pages Y et Z
Attention :
- Il ne suffit pas de mettre un lien à l’historique de vos contributions personnelles. Nous devons pouvoir distinguer les contributions associées à chaque exercice. Si vous mettez juste le lien à l’historique de vos contributions nous allons noter comme si vous n’avez pas fait de contribution.
- Vous devez avoir des contributions différentes pour les deux exercices de la même période, à vous de choisir comment répartir les contributions dans les rapports.
Quelques conseils
Voici enfin quelques conseils généraux :
- N’écrivez pas trop – entre 500 et 1'000 mots c’est plus que suffisant !
- Favorisez la lisibilité du document à des éléments artistiques.
- Si vous gardez le même modèle pour tous les rapports (ce qui est une bonne idée), veuillez faire attention à mettre à jour les éléments (numéro d’exercice, liens, etc.). Évitez d’écrire des phrases qui sont valables pour tous les exercices et de les répéter automatiquement à chaque rendu.
- Rappelez-vous que le rapport et la contribution wiki comptent chacun pour 10% de la note finale (donc le 80% dépend de votre dispositif…).