[docs-scanner] Confusing explanation of approval-required outcome vs permit in MCP policy
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 88/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Bereich
- documentation
Rechercherichtung
Öffne content/manuals/ai/governance/reference/mcp-policy.md und lies den Abschnitt „Approval annotation“. Stelle klar, dass @requireApproval ein permit kennzeichnet und vor der Zulassung der Anfrage eine Bestätigung erfordert; achte darauf, dass die Formulierung mit dem dort beschriebenen Richtlinienverhalten übereinstimmt. Die Aufgabe ist erledigt, wenn Leser erkennen können, dass ein Ergebnis mit erforderlicher Bestätigung ein gekennzeichnetes Permit und kein separates, konkurrierendes Ergebnis ist.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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
- Vorherrschende Sprache
- Markdown
- Sterne
- 4.7k
- Forks
- 8.5k
- Ø Merge
- 2 T. 13 Std.
- Gemergte PRs (30 T.)
- 139
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus docker/docs
-
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 88/100
Maintainer antworten meist innerhalb von 1 Tag
-
status/triage
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 68/100
Maintainer antworten meist innerhalb von 1 Tag
-
[docs-scanner] Unclear policy change timing in organization policies overviewEvtl. vergeben @Mhdomer hat das heute übernommen. Offen
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 89/100
Maintainer antworten meist innerhalb von 1 Tag
-
[docs-scanner] Unclear pronoun reference in cloud delivery noteEvtl. vergeben @craig-osterhout hat das vor 1 Tag übernommen. Offen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 94/100
docker/docs#26547 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
-
Debian installation pitfallEvtl. vergeben @Duo-ee hat das vor 6 Tagen übernommen. Offenstatus/triage
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
Blog update untriaged
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
-
sync-en
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag
-
documentation
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
-
fix(docs): align git__gh troubleshooting with its actual failure pathsEvtl. vergeben @akhil9tiet hat das heute übernommen. Offenbug docs p2
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 78/100
vercel/eve#6130 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
cutover-blocker documentation v2-migration
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
disnog/netranger-db#11 · 1 Kommentar ·