Skip to content

🌱 Update CloudEvents documentation to reflect current API - #213

Merged
openshift-merge-bot[bot] merged 1 commit into
open-cluster-management-io:mainfrom
skeeey:doc
Mar 12, 2026
Merged

🌱 Update CloudEvents documentation to reflect current API#213
openshift-merge-bot[bot] merged 1 commit into
open-cluster-management-io:mainfrom
skeeey:doc

Conversation

@skeeey

@skeeey skeeey commented Mar 12, 2026

Copy link
Copy Markdown
Member

remove ce mqtt integration test

Summary

Related issue(s)

Fixes #

Summary by CodeRabbit

  • Documentation

    • Updated getting started guides with reorganized examples
    • Refined protocol support documentation (gRPC and Google Cloud Pub/Sub)
    • Expanded CloudEvents client usage documentation with new initialization patterns
  • Prerequisites

    • Go version requirement updated to 1.25.0+
  • API Changes

    • Refactored client initialization with simplified options pattern
    • Enhanced client interfaces for improved usability and flexibility

@openshift-ci
openshift-ci Bot requested review from deads2k and qiujian16 March 12, 2026 02:25
@coderabbitai

coderabbitai Bot commented Mar 12, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@skeeey has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 8 minutes and 5 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2427ebb1-e390-4b79-8c3f-d73d4f20a216

📥 Commits

Reviewing files that changed from the base of the PR and between b863692 and 360a08c.

📒 Files selected for processing (3)
  • README.md
  • pkg/cloudevents/README.md
  • pkg/cloudevents/doc/design.md

Walkthrough

This PR updates documentation across the CloudEvents client library, including the root README with updated prerequisites (Go 1.25.0+) and Google Cloud Pub/Sub support, a comprehensive rewrite of the CloudEvents client documentation introducing the GenericClientOptions pattern, and design documentation reflecting a refactored API surface moving from protocol-specific to transport-oriented architecture.

Changes

Cohort / File(s) Summary
Root Documentation
README.md
Updated prerequisites to Go 1.25.0+, revised supported protocols to include Google Cloud Pub/Sub, removed Getting Started/Basic Usage sections and example code.
CloudEvents Client Documentation
pkg/cloudevents/README.md
Comprehensive rewrite documenting shift from builder patterns to GenericClientOptions-based approach; updated client creation patterns, protocol configuration requirements, introduced Advanced Options section, and added Work Clients and Additional Resource Clients sections with examples.
Design Documentation
pkg/cloudevents/doc/design.md
Documented public API refactoring including CloudEventsOptions → GenericClientOptions rename, introduction of CloudEventTransport interface, updated CloudEventsClient method signatures, new ClientWatcherStore interface, and reorganized ManifestWork client paths to ../clients/work/...; updated sequence diagrams to reflect ReconnectedChan → SubscribedChan changes.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

  • PR #190: Renames client resync signal from ReconnectedChan to SubscribedChan, directly aligned with signal naming updates in design documentation.
  • PR #128: Introduces WithSubscription flag in GenericClientOptions to control automatic Subscribe behavior, directly related to subscription configuration changes documented here.
  • PR #125: Updates AgentInformerWatcherStore type-assertion and ClientHolder code, related to watcher store refactoring and new store implementation structures documented in design.

Suggested labels

approved, lgtm

Suggested reviewers

  • deads2k
  • qiujian16
🚥 Pre-merge checks | ✅ 1 | ❌ 2

❌ Failed checks (2 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title mentions updating CloudEvents documentation to reflect current API, which partially aligns with the substantial README and design documentation changes, but does not capture that the PR primarily removes CE MQTT integration tests. Clarify the title to better reflect the primary change: either specify the focus on documentation updates or mention the test removal to align with PR description intent.
Description check ❓ Inconclusive The PR description states 'remove ce mqtt integration test' but provides only an empty template with no Summary section completed, Related issue(s) left blank, and contradicts the file-level changes which show major documentation refactoring rather than test removal. Complete the Summary section with details about changes made, clarify whether the PR focuses on test removal or documentation updates, and fill in Related issue(s) if applicable.
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
README.md (1)

29-30: Minor grammar and style suggestions.

Consider these optional improvements for consistency with American English style:

  • Use "kube-style" (with hyphen) instead of "kube style" when used as a compound adjective
  • Add period after "etc" → "etc."
✏️ Suggested style improvements
-- Specialized kube style clients, e.g. ManifestWork, etc
+- Specialized kube-style clients, e.g. ManifestWork, etc.
 - Protocol-agnostic design with pluggable transports
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 29 - 30, Update the phrasing in the README line that
currently reads "Specialized kube style clients, e.g. ManifestWork, etc" to use
the compound adjective and proper punctuation: change "kube style" to
"kube-style" and append a period to "etc" so it reads "Specialized kube-style
clients, e.g. ManifestWork, etc." (no other content changes needed).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 81: The README currently lists "Go 1.25.0 or later" but there's no
evidence in the codebase that Go 1.25 features are required; update the PR so
either (A) revert the go directive back to "go 1.24" in go.mod and README.md if
no dependency/security need exists, or (B) keep "go 1.25.0" but add a brief
justification referencing the exact cause (e.g., updated dependency requiring
1.25, a security fix, or specific language/runtime feature) in README.md and the
PR/changelog; refer to the go.mod 'go 1.25.0' directive and the README.md line
"Go 1.25.0 or later" when making the change.

---

Nitpick comments:
In `@README.md`:
- Around line 29-30: Update the phrasing in the README line that currently reads
"Specialized kube style clients, e.g. ManifestWork, etc" to use the compound
adjective and proper punctuation: change "kube style" to "kube-style" and append
a period to "etc" so it reads "Specialized kube-style clients, e.g.
ManifestWork, etc." (no other content changes needed).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0877c2c0-346e-4668-8cea-2139f52fe64b

📥 Commits

Reviewing files that changed from the base of the PR and between 8db061d and b863692.

📒 Files selected for processing (3)
  • README.md
  • pkg/cloudevents/README.md
  • pkg/cloudevents/doc/design.md

Comment thread README.md Outdated
Signed-off-by: Wei Liu <liuweixa@redhat.com>

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
@skeeey

skeeey commented Mar 12, 2026

Copy link
Copy Markdown
Member Author

/assign @qiujian16

@qiujian16

Copy link
Copy Markdown
Member

/approve
/lgtm

@openshift-ci openshift-ci Bot added the lgtm label Mar 12, 2026
@openshift-ci

openshift-ci Bot commented Mar 12, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: qiujian16, skeeey

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

@openshift-merge-bot
openshift-merge-bot Bot merged commit 70b3b43 into open-cluster-management-io:main Mar 12, 2026
9 checks passed
@skeeey
skeeey deleted the doc branch March 12, 2026 08:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants