Ressources

Références pour les participants après la séance, et repères pour les animateurs qui en préparent une.

Documentation officielle

L’exclusion de contenu n’est pas prise en charge par tous les flux, y compris certains flux d’agent et d’édition. Ne la considérez pas comme le contrôle qui rendrait un dépôt quelconque sûr à utiliser comme contexte Copilot. Les droits d’accès et le traitement des données sont des décisions organisationnelles ayant un responsable nommé.

Pages de l’atelier

Le projet d’exercice

Le projet d’exercice se trouve dans le dépôt sous workshop/fixture/. C’est un matériel pédagogique rédigé à l’origine pour cet atelier, avec deux dépendances, aucun accès réseau, aucune interface et aucune intégration de fournisseur.

Fichiers qu’un participant lirait :

Fichier Contenu
lib/scenario-engine/types.ts Les énumérations, la forme de la demande et le type de résultat discriminé
lib/scenario-engine/validateGenerateRequest.ts validateGenerateRequest et son ordre de validation fixe
lib/scenario-engine/validateGenerateRequest.test.ts La suite de tests
scripts/self-check.mjs Affiche une seule ligne de réussite ou d’échec
scripts/reset.mjs Restaure les trois fichiers d’exercice depuis une copie d’origine
VERIFICATION.md Le relevé de comportement observé, où chaque décompte est étiqueté comme observé

Commandes, exécutées depuis le répertoire du projet d’exercice :

npm ci
npm test -- lib/scenario-engine/validateGenerateRequest.test.ts
npm run typecheck
node scripts/self-check.mjs
node scripts/reset.mjs

Une exécution de tests réussie n’établit pas la correction des types, et c’est pourquoi la vérification de types est une commande distincte.

Littéraux logiciels invariants

Ce sont des valeurs de contrat de code. Elles sont identiques octet pour octet dans chaque édition linguistique de cet atelier, et ne sont jamais traduites, ni recasées, ni respacées, ni reponctuées.

Élément Valeur
Nom de la constante MAX_TITLE_LENGTH
Valeur de la constante 80
Message d’erreur Title must be at most 80 code units
Nom de la fonction validateGenerateRequest

Le message d’erreur ne porte aucun point final.

Prochaines étapes d’apprentissage

  • Refaites l’activité C sur une règle de votre propre base de code : écrivez l’objectif, le contexte, les contraintes et les tests d’acceptation avant d’ouvrir une invite.
  • Refaites la moitié relecture de l’activité D sur n’importe quelle modification générée : lisez le diff fichier par fichier, exécutez les tests, puis acceptez, refusez ou révisez.
  • Gardez l’habitude du périmètre. Nommez les fichiers qu’une modification a le droit de toucher avant de demander cette modification.

Téléchargement des diaporamas

Les diaporamas générés sont produits dans une phase ultérieure de ce projet et seront liés depuis le fichier README du dépôt dès leur livraison. Il n’y a pas encore de lien de diaporama sur cette page, car le fichier n’existe pas.


This site uses Just the Docs, a documentation theme for Jekyll.