[docs-scanner] Contradictory information about MCP approval fields in audit records
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 1/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 88/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- markdown
調査の方向性
content/manuals/ai/governance/reference/audit-records.mdを読み、「Approval fields」セクションとその表に注目してください。ネットワーク承認に適用されるフィールドとMCP承認に適用されるフィールドを明確にし、説明が本文と一貫するようにしてください。各承認タイプでどのフィールドが想定されるかを読者が判断できれば完了です。
索引モデルが issue の本文から書いたものです。
説明
File: content/manuals/ai/governance/reference/audit-records.md
Issue
The "Approval fields" section contains contradictory information about which fields appear in MCP approval records. The prose states:
For MCP approvals, an approved request is evaluated again and recorded with
AUDIT_DECISION_APPROVAL_ALLOW, and a declined request is recorded withAUDIT_DECISION_APPROVAL_DENY. Neither record includesapproval.approval_request_idorapproval.grant_scope.
However, the table immediately below lists:
| Field | Description |
|---|---|
approval.approval_request_id |
ID that links an approval required record to the record that resolves it. |
approval.grant_scope |
Scope the user accepted. Present only on AUDIT_DECISION_APPROVAL_ALLOW records. |
The table descriptions don't distinguish between network and MCP approvals, suggesting these fields are present on all AUDIT_DECISION_APPROVAL_ALLOW records, which contradicts the prose statement that MCP approvals don't include them.
Why this matters
A reader trying to parse MCP approval audit records will be confused about which fields to expect. If they follow the prose, they won't look for these fields. If they follow the table, they'll expect them to be present. This makes it impossible to correctly process MCP approval records.
Suggested fix
Clarify the table to indicate which fields apply to network approvals vs. MCP approvals. For example:
| Field | Description |
|---|---|
approval.approval_request_id |
ID that links an approval required record to the record that resolves it. Present for network approvals only. |
approval.grant_scope |
Scope the user accepted. Present only on network approval AUDIT_DECISION_APPROVAL_ALLOW records. |
Or restructure the section to have separate subsections for network approval fields and MCP approval fields.
Found by nightly documentation quality scanner
- 主要言語
- Markdown
- スター
- 4.7k
- フォーク
- 8.5k
- 平均マージ
- 2日 13時間
- マージ済み PR（30日）
- 139
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
docker/docs のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
status/triage
難易度 1/5 1時間未満 初心者へのやさしさ 68/100
メンテナーはふだん 1 日以内に返信
-
[docs-scanner] Unclear policy change timing in organization policies overview対応中かも @Mhdomer が今日担当しました。 オープン
難易度 1/5 1〜3時間 初心者へのやさしさ 89/100
メンテナーはふだん 1 日以内に返信
-
[docs-scanner] Unclear pronoun reference in cloud delivery note対応中かも @craig-osterhout が 1 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 94/100
メンテナーはふだん 1 日以内に返信
-
Debian installation pitfall対応中かも @Duo-ee が 6 日前に担当しました。 オープンstatus/triage
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
Blog update untriaged
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
-
sync-en
難易度 1/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
-
fix(docs): align git__gh troubleshooting with its actual failure paths対応中かも @akhil9tiet が今日担当しました。 オープンbug docs p2
難易度 1/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
cutover-blocker documentation v2-migration
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
disnog/netranger-db#11 · コメント 1 件 ·