Skip to content

ROX-33089: Improve language on scope step of wizard#19903

Open
bradr5 wants to merge 1 commit intomasterfrom
bradr/ROX-33089_improve_policy_scope_language
Open

ROX-33089: Improve language on scope step of wizard#19903
bradr5 wants to merge 1 commit intomasterfrom
bradr/ROX-33089_improve_policy_scope_language

Conversation

@bradr5
Copy link
Copy Markdown
Contributor

@bradr5 bradr5 commented Apr 8, 2026

Description

Improves UX copy for the policy resources step in the wizard

  • Updates “scope” terminology to “resources” in the policy wizard
    • “Scope” → “Resources” across the UI
    • “Scope inclusions/exclusions” → “Included/Excluded resources”
  • Clearer inclusion vs exclusion behavior
    • Better highlight what the policy evaluates vs does not evaluate
    • Clarifies that no inclusions = all resources
  • Added better RE2 guidance
    • Clarifies regex support across fields
    • Explains empty fields = no filtering (applies to all values)
    • Included link to RE2 syntax

User-facing documentation

Testing and quality

  • the change is production ready: the change is GA, or otherwise the functionality is gated by a feature flag
  • CI results are inspected

Automated testing

  • added unit tests
  • added e2e tests
  • added regression tests
  • added compatibility tests
  • modified existing tests

How I validated my change

Before

Screenshot 2026-04-08 at 1 40 59 PM

After

Screenshot 2026-04-08 at 1 41 17 PM

@bradr5 bradr5 requested a review from a team as a code owner April 8, 2026 18:58

return (
<PolicyScopeCardBase title="Exclusion scope" onDelete={onDelete}>
<PolicyScopeCardBase title="Excluded resource" onDelete={onDelete}>
Copy link
Copy Markdown
Contributor

@clickboo clickboo Apr 8, 2026

Choose a reason for hiding this comment

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

I would rename to Exclusion (since it is not a singular resource per rule, but will most likely be a set of resources - put differently - it is a single rule, not a single resource). Also this is the card that pops up when the user clicks on "Add exclusion".

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.

(not sure if this shows up in the UI - I think this is the card title which does)


return (
<PolicyScopeCardBase title="Inclusion scope" onDelete={onDelete}>
<PolicyScopeCardBase title="Included resource" onDelete={onDelete}>
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.

Similar suggestion: Inclusion

title={`Delete ${type} scope`}
title={
type === 'inclusion'
? 'Delete included resource'
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.

Delete inclusion/exclusion

<Flex direction={{ default: 'column' }}>
<Title headingLevel="h3">Included resources</Title>
<div>
Define which clusters, namespaces, and deployments this 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.

I know my demo said deployments but given RFEs to exclude other workload types like Jobs and CronJobs coming soon, would be nice to use workloads as the verbiage instead of deployments. I believe we are encouraging that terminology in other parts of the UI as well cc: @mansursyed

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

🚀 Build Images Ready

Images are ready for commit a62ec3e. To use with deploy scripts:

export MAIN_IMAGE_TAG=4.11.x-601-ga62ec3ee95

1 similar comment
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

🚀 Build Images Ready

Images are ready for commit a62ec3e. To use with deploy scripts:

export MAIN_IMAGE_TAG=4.11.x-601-ga62ec3ee95

<Flex direction={{ default: 'column' }}>
<Title headingLevel="h3">Excluded resources</Title>
<div>
Excluded resources define what this policy will not evaluate. They
Copy link
Copy Markdown
Contributor

@clickboo clickboo Apr 8, 2026

Choose a reason for hiding this comment

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

Exclude one or more clusters, namespaces, or workloads (if applicable) from this policy.
OR
Define one or more clusters, namespaces or workloads (if applicable) to be excluded from this policy.

</div>
<Flex direction={{ default: 'column' }}>
<Title headingLevel="h3">Included resources</Title>
<div>
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.

Apply this policy to one or more clusters, namespaces or workloads (if applicable).
OR
Define one or more clusters, namespaces of workloads (if applicable) to apply this policy to.

followed by:

If no inclusions are configured, the policy will apply to all resources in your environment, except those excluded.

(Because of the "except those excluded" , it shortens the exclusion description and succinctly conveys "They narrow the result of your inclusions (or all resources, if you added
none)."

Copy link
Copy Markdown
Contributor

@pedrottimark pedrottimark left a comment

Choose a reason for hiding this comment

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

Technical changes are solid.

Thank you Brad for discussion on Slack about markup, which is relevant to text elsewhere.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants