docs: update language from Rules to Policies to match the new dashboard changes#6471
Merged
Conversation
📝 WalkthroughWalkthroughThis PR renames Agent Control Plane documentation from “Rules” to “Policies” across localized edge pages and adds redirects from the old rules paths to the new policies paths. ChangesRules to Policies documentation rename
Suggested reviewers: 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
renatonitta
marked this pull request as ready for review
July 7, 2026 15:31
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
renatonitta
changed the title
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 8
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
docs/edge/en/enterprise/features/agent-control-plane/policies.mdx (1)
82-82: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick winFix incorrect overage percentage in example.
$0.38 vs a $0.10 budget is a +280% overage, not +277% as stated.
✏️ Proposed fix
-When an automation goes over budget, recipients get an email summarizing the overage — the automation name, the **current spend**, the **budget threshold**, and how far over it is in both dollars and percent (e.g. `$0.38` current vs a `$0.10` budget = `+277%`). The email reiterates that the run was **not** paused. +When an automation goes over budget, recipients get an email summarizing the overage — the automation name, the **current spend**, the **budget threshold**, and how far over it is in both dollars and percent (e.g. `$0.38` current vs a `$0.10` budget = `+280%`). The email reiterates that the run was **not** paused.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@docs/edge/en/enterprise/features/agent-control-plane/policies.mdx` at line 82, The overage example in the budget email copy has an incorrect percentage calculation. Update the wording in the policies documentation to reflect the correct percentage for the example in the automation budget overage description, and make sure the text under the overage summary uses the accurate value consistently.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/docs.json`:
- Around line 34727-34774: The agent-control-plane /rules redirects are being
shadowed by the locale wildcard entries in docs.json, so they need to be matched
earlier. Move the specific /rules redirect objects above the "/en/:slug*",
"/pt-BR/:slug*", "/ko/:slug*", and "/ar/:slug*" redirects, and add a bare
"/enterprise/features/agent-control-plane/rules" source alongside the existing
versioned and locale-specific entries. Use the redirect entries around the
agent-control-plane section in docs.json to place the new source consistently.
In `@docs/edge/pt-BR/enterprise/features/agent-control-plane/policies.mdx`:
- Around line 2-4: The localized page metadata still uses a mixed-language
title, so update the frontmatter title in the policies page to a fully pt-BR
phrase that matches the rest of the docs. Keep the existing description and
sidebarTitle as-is, and adjust only the title field in the page metadata for
this document.
In `@docs/v1.15.1/ar/enterprise/features/agent-control-plane/overview.mdx`:
- Around line 13-23: The rename was applied directly in the frozen release
snapshot, which must not be edited. Move this change to the source documentation
file for the Agent Control Plane overview, then regenerate the v1.15.1 snapshot
with the devtools workflow so the frozen tree is updated automatically. Use the
ACP overview section and the existing “Automations” / “Policies” headings to
locate the source text to rename.
In `@docs/v1.15.1/ar/enterprise/features/agent-control-plane/policies.mdx`:
- Around line 2-4: Do not edit the frozen docs/v1.15.1 snapshot directly in
policies.mdx; make the rename in the source documentation under the main docs
tree instead, then regenerate the versioned snapshot with the devtools workflow.
Use the existing frontmatter fields in policies.mdx as the target content to
verify the change after regeneration, and avoid hand-editing any docs/v*/
release files.
In `@docs/v1.15.1/ko/enterprise/features/agent-control-plane/monitoring.mdx`:
- Line 14: This change is in a frozen docs/v1.15.1 snapshot and should not be
edited directly. Revert the edits in monitoring.mdx and move the rename/update
through the docs redirect mechanism in docs.json or the devtools-managed release
process instead. Use the affected link entries in monitoring.mdx and the related
v1.15.1 pages as a pointer, but make the actual change outside docs/v*/.
In `@docs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/monitoring.mdx`:
- Line 14: The change was made in a frozen release snapshot, which should not be
edited directly. Update the corresponding source documentation entry for the
renamed link in the agent-control-plane monitoring docs, then regenerate the
v1.15.1 snapshot with the devtools workflow so the change is propagated
automatically; use the affected doc page in the source tree rather than
modifying the frozen monitoring.mdx snapshot.
In `@docs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/overview.mdx`:
- Around line 13-23: This change is in a frozen release snapshot and should not
be edited directly; move the rename/update in the source documentation that
defines the Agent Control Plane overview and then regenerate the v1.15.1
snapshot with the devtools workflow. Update the source page that contains the
ACP overview and the “Políticas” nav/link text so the generated release tree
picks up the change automatically, rather than hand-editing the snapshot file.
In `@docs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/policies.mdx`:
- Around line 2-4: The change was made in a frozen release snapshot, which
should not be edited directly. Update the corresponding source documentation for
the policies page (the entry with title, description, and sidebarTitle in the
source docs) and then regenerate the v1.15.1 snapshot using the devtools
workflow instead of hand-editing the file under docs/v1.15.1. Keep the rename
consistent in the source doc so the snapshot is produced automatically.
---
Outside diff comments:
In `@docs/edge/en/enterprise/features/agent-control-plane/policies.mdx`:
- Line 82: The overage example in the budget email copy has an incorrect
percentage calculation. Update the wording in the policies documentation to
reflect the correct percentage for the example in the automation budget overage
description, and make sure the text under the overage summary uses the accurate
value consistently.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro Plus
Run ID: f2fe062c-3732-45d5-993b-f35f7ee7d105
⛔ Files ignored due to path filters (6)
docs/images/enterprise/acp-automations-table.pngis excluded by!**/*.pngdocs/images/enterprise/acp-consumption-table.pngis excluded by!**/*.pngdocs/images/enterprise/acp-policies-edit-cost-limit.pngis excluded by!**/*.pngdocs/images/enterprise/acp-policies-engaged-modal.pngis excluded by!**/*.pngdocs/images/enterprise/acp-policies-list.pngis excluded by!**/*.pngdocs/images/enterprise/acp-policies-new-side-panel.pngis excluded by!**/*.png
📒 Files selected for processing (28)
docs/docs.jsondocs/edge/ar/enterprise/features/agent-control-plane/monitoring.mdxdocs/edge/ar/enterprise/features/agent-control-plane/overview.mdxdocs/edge/ar/enterprise/features/agent-control-plane/policies.mdxdocs/edge/en/enterprise/features/agent-control-plane/monitoring.mdxdocs/edge/en/enterprise/features/agent-control-plane/overview.mdxdocs/edge/en/enterprise/features/agent-control-plane/policies.mdxdocs/edge/ko/enterprise/features/agent-control-plane/monitoring.mdxdocs/edge/ko/enterprise/features/agent-control-plane/overview.mdxdocs/edge/ko/enterprise/features/agent-control-plane/policies.mdxdocs/edge/pt-BR/enterprise/features/agent-control-plane/monitoring.mdxdocs/edge/pt-BR/enterprise/features/agent-control-plane/overview.mdxdocs/edge/pt-BR/enterprise/features/agent-control-plane/policies.mdxdocs/edge/pt-BR/enterprise/features/agent-control-plane/rules.mdxdocs/v1.15.1/ar/enterprise/features/agent-control-plane/monitoring.mdxdocs/v1.15.1/ar/enterprise/features/agent-control-plane/overview.mdxdocs/v1.15.1/ar/enterprise/features/agent-control-plane/policies.mdxdocs/v1.15.1/en/enterprise/features/agent-control-plane/monitoring.mdxdocs/v1.15.1/en/enterprise/features/agent-control-plane/overview.mdxdocs/v1.15.1/en/enterprise/features/agent-control-plane/policies.mdxdocs/v1.15.1/en/enterprise/features/agent-control-plane/rules.mdxdocs/v1.15.1/ko/enterprise/features/agent-control-plane/monitoring.mdxdocs/v1.15.1/ko/enterprise/features/agent-control-plane/overview.mdxdocs/v1.15.1/ko/enterprise/features/agent-control-plane/policies.mdxdocs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/monitoring.mdxdocs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/overview.mdxdocs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/policies.mdxdocs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/rules.mdx
💤 Files with no reviewable changes (3)
- docs/v1.15.1/en/enterprise/features/agent-control-plane/rules.mdx
- docs/edge/pt-BR/enterprise/features/agent-control-plane/rules.mdx
- docs/v1.15.1/pt-BR/enterprise/features/agent-control-plane/rules.mdx
lorenzejay
approved these changes
Jul 7, 2026
lucasgomide
approved these changes
Jul 7, 2026
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit cf3a6bc. Configure here.
lorenzejay
approved these changes
Jul 7, 2026
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.
Overview
Docs counterpart of the ACP Rules → Policies rename.
The beta ACP docs still said "Rules" while the product now says "Policies".
Updates the unlisted beta pages in both the Edge channel and v1.15.1 (the default version customers see), in all 4 locales, with fresh screenshots of the renamed UI.
Main Technical Changes
rules.mdx→policies.mdxunderenterprise/features/agent-control-plane/indocs/edge/anddocs/v1.15.1/foren,pt-BR,ko,ar, with full terminology updates in each language (Regras→Políticas, 규칙→정책, قواعد→سياسات) plus mentions inoverview.mdx/monitoring.mdxdocs.json(/rules→/policiesfor un-prefixed,/v1.15.1/, and/edge/URL forms × 4 locales) , important because these pages are not in the navigation, so direct links are the only way they're reachedOld
New
Checklist
mint dev, pages render in all locales, old/rulesURL 307s to/policies)cd docs && mint devNote
Low Risk
Documentation and URL redirects only; no runtime or API changes.
Overview
Aligns Agent Control Plane beta documentation with the product rename from Rules to Policies.
The dedicated page moves from
rules.mdxtopolicies.mdxunderdocs/edge/for en, ar, ko, and pt-BR, with localized titles and body copy (e.g. Regras→Políticas, 규칙→정책, قواعد→سياسات). Overview and Monitoring pages now describe the Policies tab, link to/edge/.../policies, and reference PII policies instead of rules. Screenshots and image paths switch toacp-policies-*assets. English policies content also documents Cost Limit policy behavior where the old rules page did.docs.jsonadds 12 redirects from legacy.../agent-control-plane/rulesURLs (unprefixed,/en/, and/edge/forms × four locales) to the matching/edge/.../policiespages so bookmarked links keep working.Reviewed by Cursor Bugbot for commit 3c61e37. Bugbot is set up for automated code reviews on this repo. Configure here.