Roles refresh - #25680
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
There was a problem hiding this comment.
Assessment: 🟡 NEEDS ATTENTION
One issue found in the changed code that this PR introduces.
| linkTitle: Core roles | ||
| description: Compare Member, Editor, and Owner permissions for content, registry, and organization management. | ||
| keywords: core roles, member, editor, owner, permissions, organization, company, docker hub, docker home, security, oidc connections, teams | ||
| aliases: |
There was a problem hiding this comment.
[HIGH] Missing redirect: alias /enterprise/security/roles-and-permissions/ removed without replacement
The aliases: block was removed from this file's front matter:
aliases:
- /enterprise/security/roles-and-permissions/In Hugo, _index.md naturally serves /manuals/enterprise/security/roles-and-permissions/ (with the /manuals/ prefix). The alias above redirected the legacy short URL /enterprise/security/roles-and-permissions/ (without the prefix) — a different URL. The section _index.md only carries these aliases: /admin/organization/roles/, /security/for-admins/roles-and-permissions/, and /docker-hub/roles-and-permissions/. None cover /enterprise/security/roles-and-permissions/.
After this PR, any bookmark or external link pointing to /enterprise/security/roles-and-permissions/ will 404.
Fix: Add the alias to the _index.md front matter so the legacy redirect is preserved:
aliases:
- /admin/organization/roles/
- /security/for-admins/roles-and-permissions/
- /docker-hub/roles-and-permissions/
- /enterprise/security/roles-and-permissions/2 participants
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.