Skip to content

website/docs: Reorganize policy documentation -- Revisions#21601

Merged
dominic-r merged 1 commit intosdko/policy-docs-reorgfrom
gbr/policy-docs-reorg
Apr 14, 2026
Merged

website/docs: Reorganize policy documentation -- Revisions#21601
dominic-r merged 1 commit intosdko/policy-docs-reorgfrom
gbr/policy-docs-reorg

Conversation

@GirlBossRush
Copy link
Copy Markdown
Contributor

@GirlBossRush GirlBossRush commented Apr 14, 2026

Summary

  • Update button labels across policy and related docs to match the new modal/wizard invoker phrasing from website/docs: Modal and wizard button labels #21549
  • Trigger buttons now documented as "New {Entity}" and submit buttons as "Create {Entity}" instead of the generic "Create" / "Finish"

Targets #21133 (sdko/policy-docs-reorg).

File Old label New label
flow/index.md:53 Create / Finish New Flow / Create Flow
consent/index.md:36 Stages > Create New Stage
consent/index.md:53 Policies > Create New Policy
first-steps/index.mdx:73 Create with Provider New Application
notifications.md:55 Create or Update Create Notification Rule
notifications.md:64 Create (binding submit) Create Policy Binding
invitations.md:61 Invitations > Create New Invitation
invitations.md:158 Stages > Create New Stage
microsoft/index.md:49,73 Property Mappings > Create New Property Mapping
microsoft/index.md:88 Create with Provider New Application

Test plan

  • Verify docs build cleanly
  • Spot-check that updated labels match the current UI

Align documented button labels with the new modal/wizard invoker
phrasing: trigger buttons use "New {Entity}" and submit buttons
use "Create {Entity}" instead of the generic "Create" / "Finish".
@GirlBossRush GirlBossRush requested a review from a team as a code owner April 14, 2026 20:13
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 14, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 28bdf3e
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/69de9fd5c841850008fd1bb6
😎 Deploy Preview https://deploy-preview-21601--authentik-integrations.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 14, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 28bdf3e
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/69de9fd56c3cb700081c25f4
😎 Deploy Preview https://deploy-preview-21601--authentik-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@dominic-r
Copy link
Copy Markdown
Member

Thanks Teffen!

@dominic-r dominic-r merged commit 5eb98f7 into sdko/policy-docs-reorg Apr 14, 2026
9 checks passed
@dominic-r dominic-r deleted the gbr/policy-docs-reorg branch April 14, 2026 21:53
dominic-r added a commit that referenced this pull request Apr 16, 2026
* Reorganize policy documentation

* website/docs: address policy docs review feedback

* post-rebase

* website/docs: Reorganize policy documentation -- Revisions (#21601)

* apply suggestions

---------

Co-authored-by: Teffen Ellis <592134+GirlBossRush@users.noreply.github.com>
GirlBossRush added a commit that referenced this pull request Apr 16, 2026
* website/integrations: rename "Create with Provider" to "New Application"

The application list page now uses a split-button labeled
"New Application" instead of the old "Create with Provider" dropdown.
Update all 113 integration guides to match.

* website/docs: update flow, stage, and policy button labels

- "Create" → "New Flow", "New Stage", "New Policy" for trigger buttons
- "Finish" → "Create Flow", "Create Stage", "Create Policy" for submit
- "Create and bind stage" → "New Stage" / "Bind Existing Stage"
- "Create" (binding submit) → "Create Stage Binding"

* website/docs: update provider button labels

- "Create" → "New Provider" for trigger buttons
- "Create with Provider" → "New Application" in RAC docs
- "Create" → "New Property Mapping", "New RAC Endpoint", "New Prompt"
  for related entity creation

* website/docs: update directory button labels

- "Create" → "New Source" for federation/social login pages
- "Create" → "New Role", submit → "Create Role"
- "Create" → "New Invitation"
- Policy binding submit → "Create Policy Binding"

* website/docs: update endpoint device and system management button labels

- "Create" → "New Endpoint Connector", "New Enrollment Token",
  "New Device Access Group", "New Flow"
- Submit → "Create Device Access Group"
- "Create" → "New Notification Rule", "New Notification Transport"
- Binding submit → "Create Policy Binding"

* Reorganize policy documentation

* website/docs: address policy docs review feedback

* post-rebase

* website/docs: Reorganize policy documentation -- Revisions (#21601)

* apply suggestions

* Fix escaped.

* Fix whitespace.

* Update button label.

* Fix phrasing.

* Fix phrasing.

* Clean up stragglers.

* Format.

---------

Co-authored-by: Dominic R <dominic@sdko.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants