[docs-scanner] Confusing explanation of approval-required outcome vs permit in MCP policy
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 1/5
- Temps estimé
- Moins d'une heure
- Accessibilité débutants
- 88/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Domaine
- documentation
Piste de recherche
Ouvrez content/manuals/ai/governance/reference/mcp-policy.md et lisez la section « Approval annotation ». Précisez que @requireApproval annote un permit et exige une confirmation avant d’autoriser la requête ; veillez à ce que la formulation soit cohérente avec le comportement de la politique décrit dans cette section. Le travail est terminé lorsque les lecteurs peuvent comprendre qu’un résultat soumis à approbation est un permit annoté, et non un résultat distinct concurrent.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
File: content/manuals/ai/governance/reference/mcp-policy.md
Issue
The "Approval annotation" section states:
An approval-required outcome takes precedence over a normal
permit.
This phrasing is confusing because an approval-required outcome IS a type of permit (specifically, a permit with the @requireApproval annotation). The statement makes it sound like there are two separate, competing outcomes when in fact the approval-required outcome is just a modified permit.
Why this matters
Readers trying to understand the evaluation model will be confused about whether approval-required is a distinct decision type or a variant of permit. The current phrasing suggests they're different things that can conflict, when actually an annotated permit simply requires an extra step before allowing the request.
Suggested fix
Rewrite to clarify the relationship. For example:
When a request matches a
permitannotated with@requireApprovaland noforbidoverrides it, the policy engine returns an approval-required outcome instead of immediately allowing the request. The annotation string is shown as the elicitation reason.
Or:
A
permitwith@requireApprovalrequires user confirmation before allowing the request. This approval-required behavior takes precedence over a plainpermitwithout the annotation.
Found by nightly documentation quality scanner
- Langage dominant
- Markdown
- Étoiles
- 4.7k
- Forks
- 8.5k
- Merge moyen
- 2 j 13 h
- PR mergées (30 j)
- 139
Préparer son environnement
- Fournit un Dockerfile ou un fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de docker/docs
-
Difficulté 1/5 1-3 heures Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
status/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 68/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] Unclear policy change timing in organization policies overviewPeut-être pris @Mhdomer l’a pris aujourd’hui. Ouverte
Difficulté 1/5 1-3 heures Accessibilité débutants 89/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] Unclear pronoun reference in cloud delivery notePeut-être pris @craig-osterhout l’a pris il y a 1 jour. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 94/100
docker/docs#26547 · 1 personne assignée ·
Les mainteneurs répondent en général sous 1 jour
-
Debian installation pitfallPeut-être pris @Duo-ee l’a pris il y a 6 jours. Ouvertestatus/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de docker/docs
Issues similaires
-
Blog update untriaged
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
-
sync-en
Difficulté 1/5 1-3 heures Accessibilité débutants 82/100
Les mainteneurs répondent en général sous 1 jour
-
documentation
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
-
fix(docs): align git__gh troubleshooting with its actual failure pathsPeut-être pris @akhil9tiet l’a pris aujourd’hui. Ouvertebug docs p2
Difficulté 1/5 1-3 heures Accessibilité débutants 78/100
vercel/eve#6130 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
cutover-blocker documentation v2-migration
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
disnog/netranger-db#11 · 1 commentaire ·