Définition courte
Livrable écrit qui rassemble, pour une opportunité produit donnée, ce que l'équipe sait de son environnement — business, produit, client, utilisateur, technique, règles métier, normes, culture de terrain, concurrence, décisions déjà prises — et qui qualifie chaque élément selon qu'il est su, cru, douteux ou tu.
Définition détaillée
Le terme n'a pas de définition établie : dans la plupart des équipes, « le contexte » est un paragraphe d'introduction placé en tête d'une spécification, écrit pour situer le lecteur avant d'entrer dans la solution.
Dans les articles de ce blog, le document de contexte est un artefact autonome, antérieur à la spécification et indépendant d'elle. Il porte un statut (brouillon, en revue, validé), un responsable et une date de dernière mise à jour ; ses sections sont rattachées aux risques produit qu'elles instruisent plutôt qu'aux disciplines qui les rédigent.
Une distinction d'échelle le sépare du Contexte : le contexte est l'espace de travail durable attaché à un but, le document de contexte est un écrit daté qui en restitue l'état pour une opportunité précise.
Usage dans le domaine
Employé pour désigner le livrable dont la valeur monte quand la capacité à produire du logiciel cesse d'être rare, et pour opposer à la spécification et à la roadmap un artefact qui cadre le problème au lieu de décrire la solution.
Synonymes et variantes
« Le 00-context », du nom du fichier qui l'accueille en tête d'un dossier d'opportunité ; « le contexte d'une opportunité ».
À ne pas confondre avec
- spécification — description du comportement attendu du produit, écrite pour être construite. Elle suppose le cadrage fait ; le document de contexte le produit.
- note de cadrage — synthèse courte qui fixe un périmètre et un objectif pour lancer un travail. Elle tranche ; le document de contexte expose ce sur quoi on tranche, doutes compris.
- roadmap — séquencement daté de ce qui sera construit. Elle ordonne des décisions prises ; le document de contexte instruit celles qui ne le sont pas.
- Contexte — espace de travail durable rassemblant autour d'un but sources, notes, décisions et brouillons. Le document en est une restitution écrite et datée, pas l'espace lui-même.
Exemples
Le gabarit 00-context.md annoté par les risques qu'il instruit — viabilité business, valeur côté acheteur, valeur et utilisabilité, faisabilité.
Les quatre registres de qualification qu'il impose : ce que je sais, ce que je crois, ce qui me fait douter, ce qu'on ne dit pas.
Ambiguïtés / débats
L'emploi courant — un chapitre de contexte dans une spécification — et l'emploi retenu ici ne désignent pas le même objet, alors qu'ils portent le même nom. La différence tient à l'autonomie : un chapitre existe pour introduire une solution déjà envisagée, le document existe avant qu'aucune solution ne soit retenue.