Skip to content

docs: document enableCrossNamespace Helm value and cross-link references#46

Merged
ack-prow[bot] merged 2 commits into
aws-controllers-k8s:mainfrom
sapphirew:feat/cross-namespace-default-change
Jun 24, 2026
Merged

docs: document enableCrossNamespace Helm value and cross-link references#46
ack-prow[bot] merged 2 commits into
aws-controllers-k8s:mainfrom
sapphirew:feat/cross-namespace-default-change

Conversation

@sapphirew

Copy link
Copy Markdown
Contributor

Description of changes

Builds on #37 (cross-namespace default change). Adds user-facing documentation for the enableCrossNamespace Helm value / --enable-cross-namespace controller flag introduced in runtime#239 and code-generator#699.

Changes

  • guides/helm-values.md: Add a Cross-Namespace References section documenting the enableCrossNamespace value (type, default, description, and deprecation warning).
  • concepts.md (Field References): Add a warning noting that resource and secret references can target another namespace, gated by enableCrossNamespace, with links to Breaking Changes and the Helm value reference.
  • guides/field-export.md (Security Considerations): Correct the previous "same namespace only" statement to reflect the current cross-namespace default and the upcoming change, with cross-links.

These cover all three behaviors gated by the flag: resource references (*Ref), secret references (SecretKeyReference), and FieldExport targets.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

…amespace default change

- Add Breaking Changes page at top-level sidebar (same level as Overview, Getting Started)
- Add Documenting Breaking Changes guideline to Contributing section
- Add New badge to Breaking Changes and Contributing
- Remove New badge from EKS Capabilities, Granular IAM Roles, Using ACK with kro
@ack-prow
ack-prow Bot requested review from cheeseandcereal and michaelhtm June 23, 2026 23:56
Add an enableCrossNamespace entry to the Helm chart values reference and
cross-link it from the Field References concept and the Field Export guide,
covering the resource reference, secret reference, and field export behaviors
gated by the --enable-cross-namespace flag.
@sapphirew
sapphirew force-pushed the feat/cross-namespace-default-change branch from 9a738fa to 5123891 Compare June 23, 2026 23:58

@knottnt knottnt 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.

/lgtm

@ack-prow ack-prow Bot added the lgtm Indicates that a PR is ready to be merged. label Jun 24, 2026
@ack-prow

ack-prow Bot commented Jun 24, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: knottnt, sapphirew

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ack-prow ack-prow Bot added the approved label Jun 24, 2026
@ack-prow
ack-prow Bot merged commit 545e971 into aws-controllers-k8s:main Jun 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved lgtm Indicates that a PR is ready to be merged.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants