Skip to content

NO-JIRA: Mention the fauxinnati in the developer documentation#1308

Merged
openshift-merge-bot[bot] merged 2 commits intoopenshift:mainfrom
hongkailiu:testing-graphs
Feb 26, 2026
Merged

NO-JIRA: Mention the fauxinnati in the developer documentation#1308
openshift-merge-bot[bot] merged 2 commits intoopenshift:mainfrom
hongkailiu:testing-graphs

Conversation

@hongkailiu
Copy link
Copy Markdown
Member

@hongkailiu hongkailiu commented Jan 27, 2026

It is so cool and thus worth a paragraph in our docs for it.

Then it will be our responsibility to maintain the tool since it is public which should not increase any security risks because the tool is accessible by anyone already.

Summary by CodeRabbit

  • Documentation
    • Expanded guidance for hosting custom graphs with concrete workflow examples and setup instructions
    • Added clarifications for upstream URL configuration
    • Included references to example implementations and their limitations

It is so cool and thus worth a paragraph in our docs for it.

Then it will be our responsibility to maintain the tool since it
is public which should not increase any security risks because
the tool is accessible by anyone already.
@openshift-ci openshift-ci Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jan 27, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jan 27, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Cache: Disabled due to data retention organization setting

Knowledge base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between 3649702 and 40f904d.

📒 Files selected for processing (1)
  • docs/dev/feed-cvo-custom-graphs.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/dev/feed-cvo-custom-graphs.md

Walkthrough

Updated the feed-cvo-custom-graphs documentation to add fauxinnati example and demo references, expand hosting guidance with a concrete git-based workflow (branch creation, graph.json creation, jq validation, git commands), and clarify upstream URL usage.

Changes

Cohort / File(s) Summary
Documentation
docs/dev/feed-cvo-custom-graphs.md
Inserted fauxinnati example/demo references and limitation notes; expanded Step-2 with a concrete hosting workflow including git branch setup, creating graph.json, JSON validation with jq, and explicit upstream URL clarification.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding documentation about fauxinnati in the developer documentation. It is specific, concise, and directly related to the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Stable And Deterministic Test Names ✅ Passed PR modifies only documentation in docs/dev/feed-cvo-custom-graphs.md with no changes to test code or test names.
Test Structure And Quality ✅ Passed PR modifies only markdown documentation; no test code changes present, so Go testing practices check is not applicable.

✏️ 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

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

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@docs/dev/feed-cvo-custom-graphs.md`:
- Line 31: The documentation uses an inconsistent field reference
`cv.spec.upstream`; update the example text to reference the correct Kubernetes
resource field name (use `spec.upstream` or the fully-qualified
`clusterversion.spec.upstream`) so readers can find the right field; replace
`cv.spec.upstream` with `spec.upstream` (or `clusterversion.spec.upstream`) in
the sentence and ensure any surrounding examples/comments use the same corrected
symbol.

Comment thread docs/dev/feed-cvo-custom-graphs.md Outdated
}
```

More examples can be found at [fauxinnati](https://fauxinnati-fauxinnati.apps.ota-stage.q2z4.p1.openshiftapps.com/). See [a demo](https://asciinema.org/a/hUwpV4pyhGK0k0nI68KzAO3pv) to use it as `cv.spec.upstream`. It currently does not inject real payload URLs, and thus we cannot do a cluster upgrade with it. We may modify the returned graph and host it somewhere (see the example in this page) to achieve it.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix the field reference in the example.

cv.spec.upstream looks like a typo; readers are likely to look for spec.upstream (or clusterversion.spec.upstream).

✏️ Proposed text fix
-More examples can be found at [fauxinnati](https://fauxinnati-fauxinnati.apps.ota-stage.q2z4.p1.openshiftapps.com/). See [a demo](https://asciinema.org/a/hUwpV4pyhGK0k0nI68KzAO3pv) to use it as `cv.spec.upstream`. It currently does not inject real payload URLs, and thus we cannot do a cluster upgrade with it. We may modify the returned graph and host it somewhere (see the example in this page) to achieve it.
+More examples can be found at [fauxinnati](https://fauxinnati-fauxinnati.apps.ota-stage.q2z4.p1.openshiftapps.com/). See [a demo](https://asciinema.org/a/hUwpV4pyhGK0k0nI68KzAO3pv) to use it as `spec.upstream`. It currently does not inject real payload URLs, and thus we cannot do a cluster upgrade with it. We may modify the returned graph and host it somewhere (see the example in this page) to achieve it.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
More examples can be found at [fauxinnati](https://fauxinnati-fauxinnati.apps.ota-stage.q2z4.p1.openshiftapps.com/). See [a demo](https://asciinema.org/a/hUwpV4pyhGK0k0nI68KzAO3pv) to use it as `cv.spec.upstream`. It currently does not inject real payload URLs, and thus we cannot do a cluster upgrade with it. We may modify the returned graph and host it somewhere (see the example in this page) to achieve it.
More examples can be found at [fauxinnati](https://fauxinnati-fauxinnati.apps.ota-stage.q2z4.p1.openshiftapps.com/). See [a demo](https://asciinema.org/a/hUwpV4pyhGK0k0nI68KzAO3pv) to use it as `spec.upstream`. It currently does not inject real payload URLs, and thus we cannot do a cluster upgrade with it. We may modify the returned graph and host it somewhere (see the example in this page) to achieve it.
🤖 Prompt for AI Agents
In `@docs/dev/feed-cvo-custom-graphs.md` at line 31, The documentation uses an
inconsistent field reference `cv.spec.upstream`; update the example text to
reference the correct Kubernetes resource field name (use `spec.upstream` or the
fully-qualified `clusterversion.spec.upstream`) so readers can find the right
field; replace `cv.spec.upstream` with `spec.upstream` (or
`clusterversion.spec.upstream`) in the sentence and ensure any surrounding
examples/comments use the same corrected symbol.

Comment thread docs/dev/feed-cvo-custom-graphs.md Outdated
@DavidHurta
Copy link
Copy Markdown
Contributor

/retitle NO-JIRA: Mention the fauxinnati in the developer documentation

@openshift-ci openshift-ci Bot changed the title Doc fauxinnati NO-JIRA: Mention the fauxinnati in the developer documentation Jan 29, 2026
@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Jan 29, 2026
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

@hongkailiu: This pull request explicitly references no jira issue.

Details

In response to this:

It is so cool and thus worth a paragraph in our docs for it.

Then it will be our responsibility to maintain the tool since it is public which should not increase any security risks because the tool is accessible by anyone already.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Co-authored-by: David Hurta <hurtadavid@gmail.com>
@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Feb 25, 2026
@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented Feb 25, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: DavidHurta, hongkailiu

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:
  • OWNERS [DavidHurta,hongkailiu]

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

@hongkailiu
Copy link
Copy Markdown
Member Author

The changes are about docs. The risk is low.

/verified by @hongkailiu

@openshift-ci-robot openshift-ci-robot added the verified Signifies that the PR passed pre-merge verification criteria label Feb 26, 2026
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

@hongkailiu: This PR has been marked as verified by @hongkailiu.

Details

In response to this:

The changes are about docs. The risk is low.

/verified by @hongkailiu

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented Feb 26, 2026

@hongkailiu: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@openshift-merge-bot openshift-merge-bot Bot merged commit e835564 into openshift:main Feb 26, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. lgtm Indicates that a PR is ready to be merged. verified Signifies that the PR passed pre-merge verification criteria

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants