- Pourquoi ce Wiki?
- Comment contribuer?
2.1 Rédaction de contenu
2.2 Commentaires et reviews de pages - Règles de bon usage pour les contributeurs
3.1 Qualité des productions
3.2 Référencement des sources
L'objectif de ce wiki est la mise en commun de ressources et synthèses collaboratives dans le cadre du cursus en Technologie de l'informatique. Il est accessible en lecture à l'URL suivante :
Chaque étudiant est invité à contribuer à ce wiki, soit en regroupant des ressources (articles, revues, sites web, ...), soit en produisant une synthèse sur une thématique donnée. Ces contributions pourront ensuite être modifiées et enrichies par d'autres étudiants, et seront donc amenées à évoluer d'année en année.
Les contributions sont libres, mais pourraient éventuellement être valorisées dans le cadre d'un cours ou du portfolio, en concertation avec les enseignants concernés.
Ce wiki est un site web statique généré automatiquement par Github sur base de l'ensemble des pages Markdown présentes sur ce repository. Ajouter une page revient donc à créer un fichier Markdown, et à le placer au bon endroit dans la hiérarchie des fichiers du wiki. Afin de garantir la qualité du contenu, les contributeurs sont invités à procéder comme suit :
- Créer un fork du repository et travailler sur une copie locale de ce dernier.
- Créer une ou plusieurs pages sur base du fichier de template proposé
- Créer une Pull Request avec le nouveau contenu proposé, et une description expliquant la contribution.
La Pull Request donnera lieu à des reviews du contenu soumis, et à d'éventuelles discussions. Le contributeur est invité à participer à ces discussions et à mettre à jour sa contribution sur base des remarques reçues.
Une fois la Pull Request validée, elle sera intégrée à la version en production du wiki. Les administrateurs se chargeront de mettre la table des matières à jour.
Outre les contributions directes, les étudiants peuvent également :
- participer aux reviews des nouvelles contributions, via l'onglet Pull requests
- signaler des problèmes ou suggérer des améliorations sur des pages existantes, via l'onglet Issues.
- Traiter des "Issues" en proposant des mises à jour des pages existantes, toujours via le mécanisme de Pull Requests
Afin de construire un wiki qui soit à la fois riche, agréable à utiliser et fiable, il est important de poser quelques règles d'utilisation :
Le wiki est destiné à être utilisé par l'ensemble de la communauté TI. Afin d'en faire un outil agréable, il est important d'être attentif au confort de lecture et à la compréhension du contenu, via une attention particulière portée à l'orthographe, au style et à la mise en page.
Le Wiki TI est en français. Le français sera également la langue utilisée pour les rewiews de Pull Requests et pour les commentaires des commits.
- Le ou les auteurs d'une page regroupant des ressources se doivent d'identifier ces dernières le plus précisément possible, avec les informations suivantes :
- Nom de l'auteur et/ou organisme pour lequel il travaille
- Identification du texte : Eléments bibliographiques classiques pour une ressource papier, nom de la page, du site + URL pour une ressource en ligne
- Date de création de la ressource
- Date de consultation de la ressource (si ressource Web)
- Un petit paragraphe résumant les informations que la ressource contient
- Un avis critique sur la qualité de la ressource
- En cas de synthèse sur un sujet, le rédacteur indique soigneusement les ressources utilisées selon les pratiques bibliographiques habituelles, et référence la source de chaque information directement dans le texte (par ex : "Le DNS tourne par dessus UDP [3]" pour indiquer que cette information a été tirée de la troisième ressource de la bibliographie). En cas de citation / extrait, le rédacteur n'oublie bien entendu pas l'utilisation des guillements pour bien indiquer qu'il n'est pas l'auteur de l'élément de texte concerné.
- L'utilisation d'une intelligence artificielle est bien sûr possible, à condition que le texte produit soit majoritairement votre contribution, et à condition de le référencer explicitement et d'annexer les échanges avec le chatbot (prompts utilisés, résultats obtenus et comment ils ont été exploités, ...).