Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions content/manuals/ai/sandboxes/governance/org.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,24 @@ To create a policy:
Existing policies are listed with their name, scope, rule count, and last
update. Use the action menu (⋮) to edit or delete a policy.

## Configure a support message

Admins can add an optional support message that appears after the policy denial
details when a sandbox action is blocked by organization governance. Use it to
point members to an internal support channel, ticket queue, or security contact.

To set the message:

1. Sign in to [Docker Home](https://app.docker.com) and select your
organization.
1. Select **AI Platform**, then **Manage**.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[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.

If you leave it blank, Docker shows the policy denial without additional contact
text.

## Network policies

### Configuring org-level network rules
Expand Down