update channel API description

[xiangjingli]

• I have taken backward compatibility into consideration.

https://issues.redhat.com/browse/ACM-8973

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: xiangjingli

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

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [xiangjingli]

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

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 72.71%. Comparing base (987858a) to head (4a7ac83).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #86   +/-   ##
=======================================
  Coverage   72.71%   72.71%           
=======================================
  Files          13       13           
  Lines        1638     1638           
=======================================
  Hits         1191     1191           
  Misses        353      353           
  Partials       94       94           

Flag	Coverage Δ
unit	72.71% <ø> (ø)

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.

[xiangjingli]

@jc-berger Thanks Jake! I just fixed them all based on your comments and get them merged directly. Feel free to comment it if you find any new problems. I will open a new PR for addressing them if needed.