Synthèse Exercice 14 / 15

Documenter la solution — documentation technique

Situation professionnelle. Documentation technique. Une procédure contient cinq étapes, mais l'étape de validation finale manque.

Compétence ciblée. Spécifier et contrôler un format structuré.

Mission. Rédigez la fiche de maintenance du prompt, incluant propriétaire, version, usages autorisés, variables, limites et historique.

Exigence spécifique. Proposez un schéma à trois champs : source, resultat, points_a_verifier ; vérifiez types et champs obligatoires.

Travail demandé. Présentez votre production concrète, justifiez vos choix et indiquez comment vérifier qu'elle respecte le besoin.

Voir la correction

Résultat attendu : Une fiche de bibliothèque réutilisable.Exemple JSON valide : {"source":"message","resultat":"à préciser","points_a_verifier":[]} ; la syntaxe ne prouve pas la véracité.

Étape 1 — Lire le dossier et cadrer le besoin

Le document de travail est : « Une procédure contient cinq étapes, mais l'étape de validation finale manque. ». Il faut traiter ce contenu tel qu'il est, sans compléter les informations manquantes par supposition.

Étape 2 — Appliquer la technique du cours

Définir les colonnes ou clés, les types et la gestion des champs absents. Proposez un schéma à trois champs : source, resultat, points_a_verifier ; vérifiez types et champs obligatoires.

Exemple de démarche recevable : Exemple JSON valide : {"source":"message","resultat":"à préciser","points_a_verifier":[]} ; la syntaxe ne prouve pas la véracité.

Étape 3 — Résoudre la mission

  • Attribuez un identifiant stable et une version datée ; le titre doit annoncer l'usage.
  • Documentez les variables à remplir et les données qu'il ne faut pas transmettre.
  • Consignez les tests effectués et laissez le statut « en test » tant qu'ils ne sont pas exécutés.

Étape 4 — Contrôler et interpréter

Le résultat doit satisfaire l'objectif « Une fiche de bibliothèque réutilisable. ». Vérifiez les informations à partir du dossier initial, puis contrôlez la forme et la limite propre à la technique. Une réponse élégante mais comportant un fait inventé n'est pas acceptable.

Erreur fréquente : confondre une consigne de présentation avec une preuve de fiabilité. Une vérification indépendante reste nécessaire dès que la décision présente un enjeu.

📘 Revoir le cours : Obtenir des réponses structurées en tableaux ou JSON