📖 Adds bundle configuration documentation

[perdasilva]

Description

Adds documentation elucidating bundle configuration.

Note: we still need to harmonize this with the single-own-namespace docs. But I wanted to already get some docs feedback.

This was generated using Gemini from the current state of the openshift/enhancement PR then manually adjusted.

Reviewer Checklist

• API Go Documentation
• Tests: Unit Tests (and E2E Tests, if appropriate)
• Comprehensive Commit Messages
• Links to related GitHub Issue(s)

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign camilamacedo86 for approval. For more information see the Code Review Process.

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

Needs approval from an approver in each of these files:

• docs/draft/OWNERS

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

[netlify]

✅ Deploy Preview for olmv1 ready!

Name	Link
🔨 Latest commit	1498d0a
🔍 Latest deploy log	https://app.netlify.com/projects/olmv1/deploys/693ae399b0e83400088ad7ce
😎 Deploy Preview	https://deploy-preview-2380--olmv1.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

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

[Copilot]

Pull request overview

This PR adds comprehensive documentation for configuring OLM v1 extensions, specifically focusing on how to migrate from OLM v0 and how to configure registry+v1 bundles using the new ClusterExtension API. The documentation explains the architectural shift in configuration management, provides a step-by-step guide for inspecting bundle capabilities, and offers a configuration matrix with concrete examples for different installation scenarios.

Key changes:

• Introduces a comparison table explaining differences between OLM v0 and v1 configuration approaches
• Provides a CLI-based workflow for inspecting bundle install mode capabilities using opm
• Includes a configuration matrix mapping bundle capabilities to valid watchNamespace configurations
• Adds troubleshooting section with common error messages and resolutions

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.87%. Comparing base (ff7d3c2) to head (1498d0a).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2380      +/-   ##
==========================================
- Coverage   74.88%   72.87%   -2.01%     
==========================================
  Files          95       98       +3     
  Lines        7323     7581     +258     
==========================================
+ Hits         5484     5525      +41     
- Misses       1407     1622     +215     
- Partials      432      434       +2     

Flag	Coverage Δ
e2e	44.61% <ø> (-0.34%)	⬇️
experimental-e2e	49.32% <ø> (-0.03%)	⬇️
unit	56.82% <ø> (-2.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 5 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.