[rm3l]

Summary

• Records the decision to deprecate the generic fast OLM channel, default to per-minor-version fast-X.Y channels, narrow skipRange to force sequential upgrades, and fix the build tooling to enforce the channel model automatically.
• Captures why fast cannot be removed (namespace-wide OLM resolution impact) and why fast2 was rejected (minor versions can also contain breaking changes).
• References upstream PRs (#3821, #3822) and midstream MRs (!831–!836) that implement the decision.

Ref: RHIDP-17820

[rhdh-qodo-merge]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

[rhdh-qodo-merge]

PR Summary by Qodo

Document the RHDH operator's OLM channel management decision

📝 Documentation 🕐 10-20 Minutes

---

AI Description

• Records the decision to freeze and deprecate fast, making per-minor channels the default for
 controlled upgrades.
• Defines sequential upgrade edges and catalog-rendering safeguards to prevent unsupported version
 jumps.
• Explains the resolution risks, trade-offs, and separate upstream and midstream implementation
 work.

Diagram

graph TD
  R["Catalog renderer"] --> C["FBC catalog"] --> V["Versioned channels"]
  S["OLM Subscription"] --> C --> F["Frozen fast channel"]

Loading

High-Level Assessment

The ADR's approach is well suited to the stated goal: freezing rather than deleting fast preserves resolution for existing subscriptions, while per-minor channels require explicit opt-in. The document already considers and rejects a rolling channel, a fast2 channel, and catalog-only fixes; this PR records that decision rather than implementing it.

Files changed (1) +108 / -0

Documentation (1) +108 / -0

009-olm-fbc-channel-management.mdRecord the OLM FBC channel management decision +108/-0

Record the OLM FBC channel management decision

• Adds an ADR explaining the risks of automatic upgrades on 'fast' and broad 'skipRange' values. It specifies the intended channel, upgrade-edge, and rendering-tooling changes, weighs alternatives and consequences, and links the separate implementation work.

decisions/009-olm-fbc-channel-management.md