Skip to content

Docs/mutate existing dedicated page#2002

Open
Pittu-Sharma wants to merge 6 commits into
kyverno:mainfrom
Pittu-Sharma:docs/mutate-existing-dedicated-page
Open

Docs/mutate existing dedicated page#2002
Pittu-Sharma wants to merge 6 commits into
kyverno:mainfrom
Pittu-Sharma:docs/mutate-existing-dedicated-page

Conversation

@Pittu-Sharma
Copy link
Copy Markdown
Contributor

Related issue

Closes #1296

Proposed Changes

Migrated the "Mutate Existing" documentation from mutate.md to a new, dedicated page (mutate-existing.md) to improve discoverability and allow for deeper technical coverage of the topic.

The new page expands on the original content with additional sections covering:

  • How triggers work (Admission vs. Policy vs. Background Scanning).
  • Target selection methods and schemas.
  • The RBAC permissions requirement for the background controller.
  • Policy update behavior (mutateExistingOnPolicyUpdate).
  • A troubleshooting section with UpdateRequest examples.

A brief summary and link to the new page has been added to mutate.md to preserve navigation continuity, and the sidebar configuration (astro.config.mjs) has been updated.

Checklist

  • I have read the contributing guidelines.
  • I have inspected the website preview for accuracy.
  • I have signed off my issue.

Pittu-Sharma and others added 3 commits April 23, 2026 11:46
Signed-off-by: pittu sharma <pittusharma47@gmail.com>
Moved the 'Mutate Existing Resources' content from mutate.md into a
dedicated page (mutate-existing.md) to improve discoverability and
allow for deeper coverage of the topic.

The new page expands on the original content with additional sections
covering how triggers work, target selection methods, the permissions
requirement for the background controller, policy update behavior, and
a troubleshooting section with UpdateRequest examples.

A brief summary and link to the new page has been added to mutate.md
to preserve navigation continuity.

The new page is also added to the sidebar in astro.config.mjs under
the ClusterPolicy section.

Closes kyverno#1296

Signed-off-by: Pittu Sharma <pittusharma47@gmail.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation webhook config labels May 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

config documentation Improvements or additions to documentation webhook

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Enhancement] Better all around docs for mutate existing

2 participants