Skip to content

fix(docs): clarify Configuration packages cannot include MRAPs#1127

Open
boxcee-interview wants to merge 1 commit into
crossplane:masterfrom
boxcee-interview:fix/issue-1126-mrap-docs
Open

fix(docs): clarify Configuration packages cannot include MRAPs#1127
boxcee-interview wants to merge 1 commit into
crossplane:masterfrom
boxcee-interview:fix/issue-1126-mrap-docs

Conversation

@boxcee-interview

Copy link
Copy Markdown

Closes #1126

Problem

The MRAP docs claimed Configuration packages can include MRAPs, but the xpkg spec restricts Configuration packages to Configuration, CompositeResourceDefinition, and Composition objects only.

Solution

  • Clarify that MRAPs cannot be bundled in Configuration packages
  • Link to the xpkg spec as authoritative reference
  • Show the correct approach: use dependsOn in crossplane.yaml for Provider dependencies
  • Explain that MRAPs are applied separately by cluster operators
  • Recommend documenting MRD requirements in package READMEs
  • Update best practices section to align

How to Test

Review the updated MRAP documentation at the Configuration package activation section. Verify the changes align with the xpkg spec.

The xpkg spec restricts Configuration packages to Configuration,
CompositeResourceDefinition, and Composition objects only. MRAPs cannot
be bundled in Configuration packages.

Update docs to:
- Explain that MRAPs are applied separately by cluster operators
- Show correct approach using dependsOn in crossplane.yaml
- Recommend documenting MRD requirements in package README
- Align best practices section with this constraint

Closes crossplane#1126

Signed-off-by: Moritz Schmitz von Hülst <mschmitzvonhuelst@gmail.com>
@netlify

netlify Bot commented Jul 19, 2026

Copy link
Copy Markdown

Deploy Preview for crossplane ready!

Name Link
🔨 Latest commit de2e818
🔍 Latest deploy log https://app.netlify.com/projects/crossplane/deploys/6a5d5e5bc79782000820cfe0
😎 Deploy Preview https://deploy-preview-1127--crossplane.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: 94 (🟢 up 1 from production)
Accessibility: 90 (🔴 down 2 from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

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

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.

[Web Bug] - Managed Resource Activation Policies

1 participant