Vérification des exigences des livrables
Licence : Publié sous CC BY 4.0 — libre d'utilisation, d'adaptation et de partage avec attribution.
Une liste fournie de livrables est une affirmation d'obligation, pas une preuve. Une liste cohérente, qui utilise les bons termes et ne nomme que des artefacts réels, peut néanmoins omettre tous les éléments que le financeur exige réellement et gonfler le reste avec du travail que personne ne demande. Sa plausibilité est ce qui la rend risquée, car la personne qui la reçoit s'apprête à s'engager à produire chaque ligne.
La question que cette compétence pose pour chaque élément n'est pas "est-ce que c'est une chose réelle ?" mais "qui exige cela, et puis-je le citer ?" Lorsque la réponse est "personne", le dire est un constat, pas une lacune à combler.
Quand l'utiliser
- Quelqu'un a une liste en main (d'un modèle, d'un fournisseur, d'un consultant, d'un cadre ou d'une IA) et décide de l'adopter ou de la suivre.
- Le travail est financé, réglementé ou supervisé par un organisme qui publie ses propres exigences, modèles ou listes de contrôle.
Ne convient pas pour : élaborer une liste à partir de rien (utilisez plutôt le modèle du financeur), ou évaluer la qualité des documents finis.
Méthode
1. Cataloguez la liste fournie telle quelle
Numérotez chaque élément exactement comme fourni. Ne fusionnez pas, ne renommez pas et n'ajoutez pas encore. Enregistrez la provenance de la liste et sa date, si connue.
2. Obtenez les sources gouvernantes et lisez-les
Identifiez qui finance, réglemente ou approuve le travail. Obtenez leur modèle, liste de contrôle ou guide réel et lisez sa liste de sections. Ne raisonnez pas à partir de ce qu'un tel modèle contient "probablement". Les exigences changent à des dates d'entrée en vigueur que les résumés aval ne reprennent pas, donc le document source est le seul moyen fiable de vérifier. Notez le titre, la version et la date de chaque source.
Si une source gouvernante est inaccessible, dites-le et marquez chaque conclusion qui en dépend comme provisoire au moment où elle est tirée.
3. Étiquetez chaque élément avec une valeur d'autorité
| Étiquette | Signification | Preuve nécessaire |
|---|---|---|
| Financeur | L'organisme de financement ou de supervision l'exige | Section du modèle, clause du guide ou condition de l'accord |
| Loi/Règl. | Une loi ou un règlement l'exige | Citation de la section |
| Personne nommée | Une personne spécifique l'a demandé, à une date | Qui et quand |
| Pratique courante | Courant et peut-être utile, mais aucune autorité exigeante trouvée | Ce qui a été recherché |
"Pratique courante" est un résultat légitime, pas un échec. Signalez également tout élément qui dépend d'un organisme ou d'un rôle que le projet n'a pas (par exemple, un comité de validation de version dans un projet qui n'en a pas).
4. Trouvez les lacunes dans une seconde passe séparée
Seulement après l'étape 3, parcourez le modèle gouvernant section par section et listez chaque élément requis que la liste fournie omet. Gardez les lignes ajoutées visiblement séparées des lignes fournies, afin que tout le monde puisse dire lesquelles proviennent de la source et lesquelles l'analyse a introduites. Limitez les ajouts à ce que les sources exigent, et enregistrez tout ce qui a été envisagé et rejeté, avec une raison. Chaque ligne ajoutée est un travail remis à une personne.
5. Résultat
- Tableau : élément · source (fourni / ajouté) · étiquette d'autorité · citation ou preuve · notes (dépend d'un organisme manquant, chevauche un autre élément, etc.).
- Supprimer / Conserver / Ajouter :
- Supprimer : éléments de pratique courante sans autorité exigeante dont l'équipe n'a pas besoin. Dites pourquoi chacun est supprimé.
- Conserver : éléments avec une autorité citée, plus tout élément de pratique courante que l'équipe choisit de conserver, étiqueté comme un choix.
- Ajouter : éléments requis manquants dans la liste, chacun avec sa citation.
- Sources lues : titre, version et date de chaque document gouvernant, et tout document inaccessible.
Exemple (générique)
Une bibliothèque open-source recevant un don de logiciel se voit remettre une liste de 17 "documents de version standard" d'un consultant, regroupés en conception, construction, lancement et maintenance. La lecture du modèle propre de jalons du don montre 5 livrables requis. Deux d'entre eux sont sur la liste sous des noms différents ; trois n'y figurent pas du tout. Sur les 17 éléments fournis, 2 correspondent au don, 1 est exigé par les conditions de conformité de licence d'une dépendance, 2 ont été demandés par le mainteneur principal, et 12 sont de pratique courante sans autorité exigeante. Trois de ces 12 supposent une équipe de revue de sécurité que le projet n'a pas. Résultat : conserver 5, ajouter 3, supprimer ou rendre optionnel 12.
Sans la vérification, l'équipe se serait engagée à 17 éléments et aurait manqué 3 que les évaluateurs du don vérifient réellement.
Avant de déclarer terminé
- Chaque élément fourni a exactement une étiquette d'autorité.
- Chaque étiquette Financeur ou Loi/Règl. a une citation d'une source réellement lue.
- Le modèle gouvernant a été lu section par section, ou son absence est déclarée et les conclusions sont marquées provisoires.
- Les lignes ajoutées sont visiblement séparées des lignes fournies.
- Supprimer / Conserver / Ajouter est présent et chaque ligne a une raison.