TP 4.3 - Instructions sur le rendu 4

TP 4.3 - Instructions sur le rendu 4

[!WARNING] Pour ce rendu, il y a plusieurs deadlines intermédiaires à respecter :

  • Vous devez avoir initié la communication avant le mercredi 04/03.
  • Vous devez avoir finalisé le rendu au plus tard le dimanche 08/03 23h59.

[!IMPORTANT] Un nombre limité d’élèves peuvent contribuer par projet (un ou deux selon la taille des projets). Référez-vous à la colonne indiquant ce nombre dans Grist. Si plus d’élèves se sont déclarés intéressés que le nombre pouvant contribuer, discutez en amont entre vous pour vous répartir. Contactez-nous si besoin d’arbitrage.

[!NOTE] Vous ne pouvez choisir que les projets qui ont à la fois ANALYSE.md et DEVELOPMENT.md. Si vous souhaitez contribuer à un projet qui n’a pas encore ces deux fichiers, vous pouvez ouvrir une merge request pour les ajouter (en vous déclarant dans les colonnes idoines du Grist).

[!NOTE] Utilisez vos comptes personnels pour contribuer, et pas un compte créé pour le cours. (Bien sûr, vous pouvez créer un compte si vous n’en avez pas déjà sur la plateforme pertinente.) Si votre profil ou nom d’utilisateur ne permettent pas de vous identifier clairement (utilisation d’un pseudonyme), alors indiquez-nous quel est votre compte dans la colonne idoine de la table “eleves” du Grist.

  1. Choisissez un projet auquel vous souhaitez contribuer, validez votre choix avec vos camarades également intéressés, puis ajoutez votre nom à la colonne idoine sur Grist. Aidez-vous des rendus précédents pour choisir un projet : Si un projet est identifié comme peu actif depuis quelques mois, ou n’a qu’un seul mainteneur qui est présent le weekend uniquement, ou refuse toute contribution extérieure (par exemple), il peut être pertinent de changer d’idée de projet (cf ANALYSIS.md). De même si le projet est mal structuré et il est peu clair de comment le lancer, sans que le projet n’apporte d’aide sur la question (cf DEVELOPMENT.md).
  2. Lisez la documentation de contribution, le code de conduite éventuel, et la politique IA éventuelle. Résumez les règles à retenir dans le template ci-dessous. Si des règles vous paraissent inacceptables (le projet demande de signer un CLA avec lequel vous n’êtes pas d’accord, par exemple), changez d’idée de projet.
  3. Identifiez les différents canaux de communication, et faites-en la liste dans le template.
  4. Identifiez une issue la plus facile possible (y compris documentation, traduction, etc.) et corrigez-la en suivant le processus de contribution du projet.
  5. S’il n’y a pas d’issue facile à corriger, les alternatives suivantes sont acceptées :
    • ouvrir une issue pour signaler un problème (imprécision de la documentation, bug, etc.) – et proposer de résoudre ce problème avec une MR,
    • poser une question dans le canal approprié pour demander s’il y a des tâches faciles à faire pour une nouvelle contributrice / un nouveau contributeur – et résoudre une telle tâche facile proposée par le projet (via une MR),
    • ou action équivalente permettant un premier contact avec le projet (et son follow-up et MR associée).
    • Important : si vous avez ouvert une issue ou posé une question, suivez les réponses que vous obtenez et essayez d’aller au bout de la contribution (correction du problème, réalisation d’une contribution proposée, etc.) si possible.
  6. Faire un rapport dans un fichier COMMUNICATION_NOM.md avec liens ou captures d’écran à l’appui via une merge request [COMMUNICATION] Nom du projet dans laquelle vous expliquez votre démarche, les difficultés rencontrées, et ce que vous avez appris sur le projet.

Template :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

## Communication

Date et auteur du présent document : 1970-01-01, Alice Doe

### Liens consultés

- Guide de contribution (parties non-techniques) : https://...
- Code de conduite (si existant) : https://...
- Politique IA (si existante) : https://...

### Règles à retenir

<!-- Résumer ici les règles explicites importantes : ton attendu, bonnes pratiques d'interaction,
processus de contribution, attentes sur l'usage d'IA, etc. -->

- ...

### Canaux de communication du projet

| Canal | Lien | Usage principal | Ambiance observée |
| --- | --- | --- | --- |
| Issues | https://... | Signalement de bugs / questions | ... |
| Forum / Chat / Mailing list | https://... | ... | ... |

### Démarche suivie

<!-- Comment avez-vous communiqué ? Avez-vous rencontré des difficultés ? Quels résultats avez-vous obtenus ? -->

<!-- Inclure des liens ou des captures d'écran de vos échanges -->

Trending Tags

svg