Skip to content

website/docs: Modal and wizard button labels#21549

Open
GirlBossRush wants to merge 17 commits intomainfrom
web/docs-modal-revisions-labels
Open

website/docs: Modal and wizard button labels#21549
GirlBossRush wants to merge 17 commits intomainfrom
web/docs-modal-revisions-labels

Conversation

@GirlBossRush
Copy link
Copy Markdown
Contributor

@GirlBossRush GirlBossRush commented Apr 11, 2026

Summary

  • Rename Create with ProviderNew Application across 113 integration guides
  • Update generic Create trigger buttons → New {Entity} (e.g. New Flow, New Stage, New Policy, New Provider, New Source)
  • Update submit buttons → Create {Entity} (e.g. Create Flow, Create Policy Binding)
  • Update Create and bind stageNew Stage / Bind Existing Stage
  • Update special labels: Import, Generate, Install for certificates, blueprints, and licenses

Test plan

  • Verify updated button names match the UI after the modal revisions PR (web/a11y: Modal revisions, behavior fixes #21206) lands
  • Spot-check a few integration guides for correct wording
  • Spot-check flow, stage, and policy docs for correct trigger vs. submit labels
*Companion to #21206.*

Companion to #21336

@GirlBossRush GirlBossRush requested a review from a team as a code owner April 11, 2026 06:51
@GirlBossRush GirlBossRush self-assigned this Apr 11, 2026
@GirlBossRush GirlBossRush added a11y Features or issues related to accessibility area:docs Features or issues related to Docusaurus labels Apr 11, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 11, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 8763581
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/69df810aae2ed60008c7d9e7
😎 Deploy Preview https://deploy-preview-21549--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 11, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 8763581
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/69df810a08e9240008fcd381
😎 Deploy Preview https://deploy-preview-21549--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.

@GirlBossRush GirlBossRush changed the title website: update docs for new modal and wizard button labels website/docs: Modal and wizard button labels Apr 11, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.29%. Comparing base (26bfb6e) to head (8763581).
⚠️ Report is 5 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #21549      +/-   ##
==========================================
- Coverage   92.30%   92.29%   -0.02%     
==========================================
  Files        1032     1032              
  Lines       59767    59767              
  Branches     2537     2537              
==========================================
- Hits        55168    55162       -6     
- Misses       4536     4540       +4     
- Partials       63       65       +2     
Flag Coverage Δ
conformance 36.98% <ø> (+<0.01%) ⬆️
e2e 42.89% <ø> (-0.03%) ⬇️
integration 33.90% <ø> (-0.02%) ⬇️
rust 60.50% <ø> (-0.08%) ⬇️
unit 91.92% <ø> (+<0.01%) ⬆️
unit-migrate 92.01% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 11, 2026

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-111b000697d8380033a76a4077a867a9d6939110
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-111b000697d8380033a76a4077a867a9d6939110

Afterwards, run the upgrade commands from the latest release notes.

Copy link
Copy Markdown
Member

@dominic-r dominic-r left a comment

Choose a reason for hiding this comment

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

I'd prefer to keep this existing bit, unless it's no longer gonna be possible in the product (Alternatively you can first create a provider separately, then create the application and connect it with the provider.) cc @tanberry

@tanberry tanberry self-requested a review April 13, 2026 09:43

1. Log in to authentik as an administrator and open the authentik Admin interface.
2. Navigate to **Flows and Stages > Stages** and click **Create**.
2. Navigate to \*\*Flows and Stages > Stages\*\* and click \*\*New Stage\*\*.
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.

Suggested change
2. Navigate to \*\*Flows and Stages > Stages\*\* and click \*\*New Stage\*\*.
2. Navigate to **Flows and Stages > Stages** and click **New Stage**.

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.

How do those backslashes get added? Happens to me too...


1. [Create](../../flow/index.md#create-a-flow) a new flow or edit an existing one.
2. On the flow's **Stage Bindings** tab, click **Create and bind stage** to create and add the Email Authenticator Setup stage. (If the stage already exists, click **Bind existing stage**.)
2. On the flow's **Stage Bindings** tab, click **New Stage** to create and add the Email Authenticator Setup stage. (If the stage already exists, click **Bind Existing Stage**.)
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.

What is the goal of changing these labels, especially this one? When I am on a Flow page, the original label of “Create and bind stage” feels so much more informative and clear to me… the new label of “New Stage" does not tell me that I will also be able to bind the stage.. it says I can just create a new stage (which I would normally do over on the Stages page).

3. In the list of flows, click the name of the flow to which you want to bind one or more stages.
4. On the Flow page, click the **Stage Bindings** tab at the top.
5. Here, you can decide if you want to create a new stage and bind it to the flow (**Create and bind Stage**), or if you want to select an existing stage and bind it to the flow (**Bind existing stage**).
5. Here, you can decide if you want to create a new stage and bind it to the flow (**New Stage**), or if you want to select an existing stage and bind it to the flow (**Bind Existing Stage**).
Copy link
Copy Markdown
Contributor

@tanberry tanberry Apr 13, 2026

Choose a reason for hiding this comment

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

Is there a decision to use capitalization on every word across all labels/buttons? We don't now, in many cases, especially where the label is more of a psuedo-sentence. We'll want to consider whether this style in the UI will "clash" stylistically with our Docs, where we use sentence-style capitalization....

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.
- "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"
- "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
- "Create" → "New Source" for federation/social login pages
- "Create" → "New Role", submit → "Create Role"
- "Create" → "New Invitation"
- Policy binding submit → "Create Policy Binding"
- "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"
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 15, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit b3b9dd8
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/69df7ed49d05cb0008e9da21
😎 Deploy Preview https://deploy-preview-21549--authentik-storybook.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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

a11y Features or issues related to accessibility area:docs Features or issues related to Docusaurus

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants