Skip to content

OCM-19812: Improve local development documentation#569

Open
Alcamech wants to merge 1 commit intoopenshift:masterfrom
Alcamech:OCM-19812
Open

OCM-19812: Improve local development documentation#569
Alcamech wants to merge 1 commit intoopenshift:masterfrom
Alcamech:OCM-19812

Conversation

@Alcamech
Copy link

@Alcamech Alcamech commented Jan 23, 2026

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Summary by CodeRabbit

  • Documentation
    • Restructured development documentation with new consolidated sections for "Development Environment Setup", "Running Locally", and "Running Remotely" to improve clarity.
    • Simplified command formatting and removed unnecessary command prompts.
    • Added macOS-specific build guidance.
    • Streamlined instructions and workflow descriptions for local and remote setups.

@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 23, 2026
@openshift-ci-robot
Copy link

openshift-ci-robot commented Jan 23, 2026

@Alcamech: This pull request references OCM-19812 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

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 openshift-ci bot requested review from devppratik and ravitri January 23, 2026 19:54
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Jan 23, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Alcamech
Once this PR has been reviewed and has the lgtm label, please assign dustman9000 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found 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

@Alcamech Alcamech mentioned this pull request Jan 26, 2026
2 tasks
@rawsyntax
Copy link
Member

LGTM

@coderabbitai
Copy link

coderabbitai bot commented Mar 2, 2026

Walkthrough

The Development documentation file underwent structural reorganization, consolidating multiple nested sections into simplified top-level headings: "Development Environment Setup," "Running Locally," and "Running Remotely." Command formatting was standardized by removing shell prompts, and content was streamlined by removing detailed subsections and consolidating instructions.

Changes

Cohort / File(s) Summary
Documentation Restructuring
docs/development.md
Reorganized development guide: consolidated nested navigation into top-level sections, renamed subsections, removed step-by-step local run instructions and "Trigger Reconcile" subsection, standardized shell command formatting by removing prompt symbols, and simplified overall content structure while retaining maintenance section.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 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 'OCM-19812: Improve local development documentation' directly relates to the main change: structural reorganization and improvement of the development.md documentation file.
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 only modifies docs/development.md with no changes to test files containing test names or titles.
Test Structure And Quality ✅ Passed This pull request contains only documentation changes to docs/development.md and does not modify any test code. The custom check for test code quality 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

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


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.

@openshift-ci-robot
Copy link

openshift-ci-robot commented Mar 2, 2026

@Alcamech: This pull request references OCM-19812 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Summary by CodeRabbit

  • Documentation
  • Restructured development documentation with new consolidated sections for "Development Environment Setup", "Running Locally", and "Running Remotely" to improve clarity.
  • Simplified command formatting and removed unnecessary command prompts.
  • Added macOS-specific build guidance.
  • Streamlined instructions and workflow descriptions for local and remote setups.

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.

Copy link

@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

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/development.md`:
- Around line 91-95: The documentation shows inconsistent test commands: the
prose says "make test" but the code block uses "make go-test"; update the docs
so both prose and the code block use the same command (choose either "make test"
or "make go-test") and make the change in the docs/development.md text
surrounding the testing instruction so the sentence and the fenced shell snippet
match (look for the lines containing "make test" and the code block with "make
go-test").

ℹ️ 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 20d3ddc and 71b4afb.

📒 Files selected for processing (1)
  • docs/development.md

Comment on lines 91 to 95
To run unit tests locally, call `make test`

```shell
$ make go-test
make go-test
```
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix command mismatch in testing instructions.

Line 91 says to run make test, but Line 94 shows make go-test. Please make prose and command consistent to avoid confusion.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/development.md` around lines 91 - 95, The documentation shows
inconsistent test commands: the prose says "make test" but the code block uses
"make go-test"; update the docs so both prose and the code block use the same
command (choose either "make test" or "make go-test") and make the change in the
docs/development.md text surrounding the testing instruction so the sentence and
the fenced shell snippet match (look for the lines containing "make test" and
the code block with "make go-test").

@openshift-ci
Copy link
Contributor

openshift-ci bot commented Mar 2, 2026

@Alcamech: 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

jira/valid-reference Indicates that this PR references a valid Jira ticket of any type.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants