Skip to content

DOCS-3096: Fix inaccuracies on the StagedKubernetesNetworkPolicy reference - #3117

Merged
ctauchen merged 6 commits into
tigera:mainfrom
ctauchen:DOCS-3096-fact-check-stagedkubernetesnetworkpolicy
Oct 19, 2026
Merged

ctauchen merged 6 commits into
tigera:mainfrom
ctauchen:DOCS-3096-fact-check-stagedkubernetesnetworkpolicy

Conversation

@ctauchen

@ctauchen ctauchen commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

Fixes statements on the StagedKubernetesNetworkPolicy reference that a test cluster showed to be wrong.

Jira: https://tigera.atlassian.net/browse/DOCS-3096

  • The page said persisting the resource creates a Kubernetes network policy. No policy object is created; it is converted to a Calico network policy that is not enforced.
  • The page had no Spec table. It now documents stagedAction, podSelector, ingress, egress and policyTypes, including that an omitted policyTypes means ingress only.

Changes next, 3.33 and 3.32, reproduced on v3.33.0 and v3.32.2, and 3.31, reproduced on v3.31.7.

  • In next and 3.33, the policyTypes row says what each mode stores when the field is omitted and the policy has egress rules, and the stagedAction row says to leave other fields empty with Delete, because only calicoctl enforces it.

Next and 3.33 were verified in both API server mode and native v3 CRD mode.

Not changed:

  • The API also stores policyTypes values other than Ingress and Egress and treats them as ingress only. The table does not say so.
  • The Definition link still points at the Kubernetes v1.21 API reference.

Preview:

Copilot AI lite review requested due to automatic review settings October 16, 2026 07:23

Copilot AI left a comment

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.

🟢 Approval recommended

The reviewed documentation updates address the stated inaccuracies across all affected versions.

0 open findings

What changed in this PR

Updates the StagedKubernetesNetworkPolicy reference to correct persistence behavior and document its specification fields across current and v3.31–v3.33 documentation.

Changes:

  • Clarifies conversion to a non-enforced Calico policy.
  • Documents stagedAction, selectors, rules, and policyTypes.
  • Applies updates to all reviewed versions.
File Description
calico/​reference/​resources/​stagedkubernetesnetworkpolicy.mdx Updated current reference documentation.
calico_versioned_docs/​version-3.33/​reference/​resources/​stagedkubernetesnetworkpolicy.mdx Updated v3.33 reference documentation.
calico_versioned_docs/​version-3.32/​reference/​resources/​stagedkubernetesnetworkpolicy.mdx Updated v3.32 reference documentation.
calico_versioned_docs/​version-3.31/​reference/​resources/​stagedkubernetesnetworkpolicy.mdx Updated v3.31 reference documentation.

🧠 Review effort: Lite


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@netlify

netlify Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit e11d0f2
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6ad6143aa244915d351ad87a
😎 Deploy Preview https://deploy-preview-3117--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@netlify

netlify Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit e11d0f2
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6ad6143a080af6e32fb83785
😎 Deploy Preview https://deploy-preview-3117--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 68 (🔴 down 5 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

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

@ctauchen
ctauchen marked this pull request as ready for review October 19, 2026 15:51
@ctauchen
ctauchen requested a review from a team as a code owner October 19, 2026 15:51
@ctauchen
ctauchen merged commit 89bb3ac into tigera:main Oct 19, 2026
11 checks passed
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