Skip to content

📖 fix broken catalod api reference link #2152

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

anik120
Copy link
Contributor

@anik120 anik120 commented Aug 19, 2025

The make target crd-ref-docs generates the api reference doc operator-controller-api-reference.md using the API types in the api/ directory.
The docs structure was expecting two files, while only one file was being generated.

This PR fixes the doc structure to expect only one file, getting rid of a broken link as a result.

Description

Reviewer Checklist

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

The make target `crd-ref-docs` generates the api reference doc
operator-controller-api-reference.md using the API types in the
`api/` directory.
The docs structure was expecting two files, while only one file
was being generated.

This PR fixes the doc structure to expect only one file, getting
rid of a broken link as a result.
@anik120 anik120 requested a review from a team as a code owner August 19, 2025 18:06
Copy link

netlify bot commented Aug 19, 2025

Deploy Preview for olmv1 ready!

Name Link
🔨 Latest commit 0979e4d
🔍 Latest deploy log https://app.netlify.com/projects/olmv1/deploys/68a4bfe465d2ca000842df05
😎 Deploy Preview https://deploy-preview-2152--olmv1.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@grokspawn
Copy link
Contributor

grokspawn commented Aug 19, 2025

IMHO, if we're going to drop discrete operator-controller / catalogd nomenclature w.r.t. the API docs, then we should consistently refer to it as "OLMv1 API", not "operator-controller", like here.

@anik120
Copy link
Contributor Author

anik120 commented Aug 19, 2025

IMHO, if we're going to drop discrete operator-controller / catalogd nomenclature w.r.t. the API docs, then we should consistently refer to it as "OLMv1 API", not "operator-controller", like here.

@grokspawn that is totally fair. Pushed a new commit renaming that part. PTAL.

Copy link

codecov bot commented Aug 19, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.83%. Comparing base (35bcd7a) to head (0979e4d).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2152      +/-   ##
==========================================
+ Coverage   72.75%   72.83%   +0.08%     
==========================================
  Files          79       79              
  Lines        7340     7340              
==========================================
+ Hits         5340     5346       +6     
+ Misses       1653     1649       -4     
+ Partials      347      345       -2     
Flag Coverage Δ
e2e 44.43% <ø> (?)
experimental-e2e 55.16% <ø> (+0.24%) ⬆️
unit 58.24% <ø> (+0.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.

@grokspawn
Copy link
Contributor

/lgtm
(I have no approver powers in this repo)

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Aug 19, 2025
@grokspawn
Copy link
Contributor

still some warnings in the workflow
Would you please capture an issue for these in the backlog, @anik120?
(Ideally, the CI would fail on warnings.)

@grokspawn
Copy link
Contributor

Ooh. First time we've had a PR with contributions across api, Makefile, docs areas, so I'm curious to see how the new ladder works.

/approve

@grokspawn
Copy link
Contributor

Ladder works. 😁

Copy link

openshift-ci bot commented Aug 20, 2025

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: grokspawn, perdasilva

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:

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

@openshift-ci openshift-ci bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 20, 2025
@openshift-merge-bot openshift-merge-bot bot merged commit 528b321 into operator-framework:main Aug 20, 2025
24 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. lgtm Indicates that a PR is ready to be merged.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants