Roles refresh - #25680
Merged
Merged
Conversation
Remove the core-roles alias that redirected the section overview, and split custom roles into conceptual, manage, and permissions-reference pages. Co-authored-by: Cursor <cursoragent@cursor.com>
Apply tier 1 and tier 2 freshness to the roles section: tighten SEO and style, clarify structure, and fix the org access token permission text. Co-authored-by: Cursor <cursoragent@cursor.com>
Reduce the overview to role concepts and choosing between core and custom roles, and group the core roles tables under a permissions reference heading. Update the Build Cloud deep link for the renamed anchor. Co-authored-by: Cursor <cursoragent@cursor.com>
Match the core roles intro structure, correct the permission category list to the categories in the reference, and refresh the description, keywords, and wording. Co-authored-by: Cursor <cursoragent@cursor.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
Contributor
There was a problem hiding this comment.
Assessment: 🟡 NEEDS ATTENTION
One issue found in the changed code that this PR introduces.
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Custom roles pages used the General admin summary bar, which only showed Administrators. Added a Custom roles summary.yaml entry so the banner shows Business and Administrators. Co-authored-by: Cursor <cursoragent@cursor.com>
The permissions reference omitted categories and descriptions shown in Docker Home. Updated the tables to match the current custom role permission picker. Co-authored-by: Cursor <cursoragent@cursor.com>
Titles, keywords, and UI wording were inconsistent with the style guide. Refreshed copy, headings, and navigation instructions on the custom roles and core roles pages. Co-authored-by: Cursor <cursoragent@cursor.com>
Resolved a modify/delete conflict on sandboxes org.md by keeping the upstream move to access-controls/organization.md and updating custom-roles links. Co-authored-by: Cursor <cursoragent@cursor.com>
Prerequisites sat after the Custom roles section, so subscription and owner requirements appeared after the feature definition. Moved Prerequisites to follow the intro. Co-authored-by: Cursor <cursoragent@cursor.com>
aevesdocker
reviewed
Aug 19, 2026
aevesdocker
left a comment
aevesdocker
left a comment
Contributor
There was a problem hiding this comment.
Love it when a long page gets split out, tres bon. Minor comments only
…om-roles/_index.md Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addressing some staleness on the custom roles permissions doc. While in the area, decided to make updates to the area so it scales out more.
Need to add that it's Business plans only