docs: add AI governance support message#25579
Conversation
Document the optional support message admins can configure for organization governance policy denials. Explain where to set the message in Docker Home and when members see it. Co-Authored-By: Codex <codex@openai.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
The new Configure a support message section is concise, well-structured, and follows Docker documentation style conventions. No issues found.
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟡 NEEDS ATTENTION
|
|
||
| 1. Sign in to [Docker Home](https://app.docker.com) and select your | ||
| organization. | ||
| 1. Select **AI Platform**, then **Manage**. |
There was a problem hiding this comment.
[MEDIUM] Navigation path inconsistency: Select **AI Platform**, then **Manage**
This step differs from the existing navigation pattern used elsewhere in the same file, which says:
"In the left-hand navigation, expand AI Platform and select Network access or Filesystem access."
The new step omits the "expand" instruction and refers to a Manage sub-item that isn't documented anywhere else in the file. If Manage isn't the correct label, or if the path should be something like AI Platform > Governance, admins may not be able to find the support message setting.
Consider aligning with the existing pattern, e.g.:
In the left-hand navigation, expand **AI Platform** and select **Governance**.
(Replace Governance with the actual UI label.)
| 1. In **Support message**, enter up to 500 characters. | ||
| 1. Select **Save changes**. | ||
|
|
||
| The message is shown only for denials caused by organization governance policy. |
There was a problem hiding this comment.
[MEDIUM] Passive voice: "The message is shown only for denials…"
Docker's style guide prefers active voice. This sentence uses passive voice ("is shown"), while the very next sentence correctly uses active voice ("Docker shows…").
Suggested fix:
Docker shows the message only for denials caused by organization governance policy.
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
The new Configure a support message section is well-scoped and consistent with the rest of the document. It uses correct bold formatting for UI elements, follows the existing ordered-list style, avoids AI-isms, and includes clear edge-case handling ("If you leave it blank…"). No missing redirects, no broken Markdown, no front matter issues.
3 participants
Summary
Document the optional AI governance support message that organization admins can configure in Docker Home. The new section explains where to set the message and that it appears only when organization governance blocks a sandbox action.
Related to docker/sandboxes#4334
Generated by Codex