Skip to content

Conversation

@haarchri
Copy link
Member

The API documentation was only displaying one version per CRD resource, even when multiple versions were marked as served: true.

For example, the CompositeResourceDefinition CRD has both v1 (deprecated, storage version) and v2 (active, non-storage version), but only v1 was being shown.

This occurred because:

  • The template logic selected a single "preferred" version using getVersionAndSchema
  • The selection logic prioritized the storage version (v1) over newer served versions (v2)
  • Only one entry was generated per CRD file
  • Additionally, when attempting to show multiple versions, clicking on any version would expand/collapse ALL versions of that CRD because they shared the same DOM element ID.
image image image

Fixes: #1011

…tion

Signed-off-by: Christopher Haar <christopher.haar@upbound.io>
@netlify
Copy link

netlify bot commented Nov 26, 2025

Deploy Preview for crossplane ready!

Name Link
🔨 Latest commit d2dce97
🔍 Latest deploy log https://app.netlify.com/projects/crossplane/deploys/6927540538e7a00008fe2a0c
😎 Deploy Preview https://deploy-preview-1027--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: 95 (no change 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.

@haarchri haarchri requested a review from jbw976 November 26, 2025 19:29
Copy link
Collaborator

@jeanduplessis jeanduplessis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for the fix @haarchri

@jeanduplessis jeanduplessis merged commit a46fac4 into crossplane:master Nov 27, 2025
6 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.

API Reference missing v2 APIs

2 participants