Skip to content

feat(docs): Migrate to central ODG documentation#874

Merged
zkdev merged 8 commits into
open-component-model:masterfrom
zkdev:migrate-docs
Jul 1, 2026
Merged

feat(docs): Migrate to central ODG documentation#874
zkdev merged 8 commits into
open-component-model:masterfrom
zkdev:migrate-docs

Conversation

@zkdev

@zkdev zkdev commented Jun 30, 2026

Copy link
Copy Markdown
Member

What this PR does / why we need it:
Documentation was centralised to https://github.com/open-component-model/open-delivery-gear.
Focus this repository to dev-only instructions.

Which issue(s) this PR fixes:
Fixes #

Special notes for your reviewer:

Release note:

NONE

@zkdev zkdev requested a review from a team as a code owner June 30, 2026 11:44
@zkdev zkdev self-assigned this Jun 30, 2026
@zkdev zkdev added kind/task small task, normally part of feature or epic area/ipcei Important Project of Common European Interest labels Jun 30, 2026
@coderabbitai

coderabbitai Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@zkdev, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 57 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fed7f6f7-4b87-44a9-b9d0-21d473b6b72b

📥 Commits

Reviewing files that changed from the base of the PR and between 0a759d6 and 3df5a5a.

⛔ Files ignored due to path filters (12)
  • docs/clamav/clamav-to-delivery-gear-extensions.png is excluded by !**/*.png
  • docs/clamav/clamav-to-delivery-gear-extensions.svg is excluded by !**/*.svg
  • docs/delivery-db-backup/delivery-db-backup-cronjob.png is excluded by !**/*.png
  • docs/delivery-db-backup/delivery-db-backup-cronjob.svg is excluded by !**/*.svg
  • docs/res/artefact-metadata.svg is excluded by !**/*.svg
  • docs/res/download-sbom-button.svg is excluded by !**/*.svg
  • docs/res/download-sbom-popover.svg is excluded by !**/*.svg
  • docs/res/favicon.ico is excluded by !**/*.ico
  • docs/res/finding-states.svg is excluded by !**/*.svg
  • docs/res/general-overview.svg is excluded by !**/*.svg
  • docs/res/issues-overview.svg is excluded by !**/*.svg
  • docs/res/sbom-generator-overview.svg is excluded by !**/*.svg
📒 Files selected for processing (20)
  • .github/workflows/build.yaml
  • Makefile
  • README.md
  • docs/artefact_metadata_query.rst
  • docs/clamav/clamav-to-delivery-gear-extensions.excalidraw
  • docs/conf.py
  • docs/contribute_extension.rst
  • docs/css/custom.css
  • docs/delivery-db-backup/delivery-db-backup-cronjob.excalidraw
  • docs/delivery_service.rst
  • docs/extensions/artefact_enumerator.rst
  • docs/extensions/diki.rst
  • docs/extensions/issue_replicator.rst
  • docs/extensions/responsibles.rst
  • docs/extensions/sbom_generator.rst
  • docs/index.rst
  • docs/local_setup.rst
  • docs/model.rst
  • docs/res/issues-overview.excalidraw
  • docs/res/sbom-generator.excalidraw
📝 Walkthrough

Walkthrough

Introduces a new Makefile with targets for setup, lint, format, test, build (clients/core/Docker), run, and clean. CI jobs in build.yaml are updated to call make lint and make test. The README.md is restructured with new sections. All Sphinx documentation files under docs/ are removed.

Makefile, CI, and README

Layer / File(s) Summary
Makefile targets
Makefile
Adds all Makefile targets: help, setup, lint, format, test, build-clients, build-core, build-docker, run, and clean, with default DB_* and port config variables. build-docker validates ODG_CORE_LIBS_VERSION and dist/ before building odg-core:<version>. run constructs a --delivery-db-url from DB_* variables.
CI wiring
.github/workflows/build.yaml
lint job replaces .ci/lint call with make lint; unittests job replaces .ci/test call with make test.
README restructure
README.md
README rewritten with Technology, Getting Started (Standalone and KinD subsections referencing make setup/make run), Documentation quicklinks, and a Packages table listing odg-core-libs, odg-client, bdba-client, and odg-core.

🐇 Hoppity hop, the Makefile's here,
make lint, make test, make run — all clear!
Old .ci/ scripts, we bid adieu,
The README shines with structure new.
make clean sweeps the warren floor,
A tidy burrow forevermore! 🌿

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested labels

kind/refactor

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title matches the main change: moving documentation to a central ODG repo and refocusing this repo on docs/dev workflow.
Description check ✅ Passed It includes the required sections and describes the documentation centralization, repo focus, and release note.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@github-project-automation github-project-automation Bot moved this to 🔦 Needs Triage in Open Delivery Gear Jun 30, 2026
@zkdev zkdev linked an issue Jun 30, 2026 that may be closed by this pull request
16 tasks
@github-project-automation github-project-automation Bot moved this to 🔦 Needs Triage in Open Delivery Gear Jun 30, 2026
@zkdev zkdev moved this from 🔦 Needs Triage to 🔍 Review in Open Delivery Gear Jun 30, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@Makefile`:
- Around line 102-106: The Makefile’s runserver target builds the delivery DB
URL by interpolating DB_USER/DB_PASSWORD directly into the URI, which breaks
when the password contains reserved characters. Update the run target around the
runserver invocation to avoid raw string interpolation—either pass the DB URL
via an encoded/override-safe variable or construct it using proper URL escaping
before handing it to adev runserver. Keep the existing delivery-db-url wiring,
but ensure the value is safe for credentials with characters like @, :, /, and
%.
- Around line 51-53: The test target is passing an empty positional argument
through the Makefile, which can be interpreted by the test runner as a path.
Update the test target in Makefile so the command that invokes the .ci/test
script does not include the empty argument, and keep the existing test
entrypoint behavior otherwise.

In `@README.md`:
- Line 20: The README description uses an incorrect relative link for Open
Component Model; update the Markdown in the README text that mentions
ocm.software so it points to the external site instead of a repo-relative path.
Locate the existing hyperlink near the API overview and replace it with the
proper absolute URL while keeping the surrounding sentence unchanged.
- Line 16: The Packages table-of-contents link points to the wrong anchor, so
update the markdown entry to match the actual heading-generated slug for the
README’s Packages section. Locate the TOC item labeled Packages and change its
target from the incorrect anchor to the one produced by the `## Packages`
heading so the link resolves correctly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7b4d064-7a28-444c-976f-302a501ff404

📥 Commits

Reviewing files that changed from the base of the PR and between 08ce125 and 0a759d6.

⛔ Files ignored due to path filters (12)
  • docs/clamav/clamav-to-delivery-gear-extensions.png is excluded by !**/*.png
  • docs/clamav/clamav-to-delivery-gear-extensions.svg is excluded by !**/*.svg
  • docs/delivery-db-backup/delivery-db-backup-cronjob.png is excluded by !**/*.png
  • docs/delivery-db-backup/delivery-db-backup-cronjob.svg is excluded by !**/*.svg
  • docs/res/artefact-metadata.svg is excluded by !**/*.svg
  • docs/res/download-sbom-button.svg is excluded by !**/*.svg
  • docs/res/download-sbom-popover.svg is excluded by !**/*.svg
  • docs/res/favicon.ico is excluded by !**/*.ico
  • docs/res/finding-states.svg is excluded by !**/*.svg
  • docs/res/general-overview.svg is excluded by !**/*.svg
  • docs/res/issues-overview.svg is excluded by !**/*.svg
  • docs/res/sbom-generator-overview.svg is excluded by !**/*.svg
📒 Files selected for processing (20)
  • .github/workflows/build.yaml
  • Makefile
  • README.md
  • docs/artefact_metadata_query.rst
  • docs/clamav/clamav-to-delivery-gear-extensions.excalidraw
  • docs/conf.py
  • docs/contribute_extension.rst
  • docs/css/custom.css
  • docs/delivery-db-backup/delivery-db-backup-cronjob.excalidraw
  • docs/delivery_service.rst
  • docs/extensions/artefact_enumerator.rst
  • docs/extensions/diki.rst
  • docs/extensions/issue_replicator.rst
  • docs/extensions/responsibles.rst
  • docs/extensions/sbom_generator.rst
  • docs/index.rst
  • docs/local_setup.rst
  • docs/model.rst
  • docs/res/issues-overview.excalidraw
  • docs/res/sbom-generator.excalidraw
💤 Files with no reviewable changes (16)
  • docs/index.rst
  • docs/extensions/diki.rst
  • docs/extensions/sbom_generator.rst
  • docs/contribute_extension.rst
  • docs/extensions/responsibles.rst
  • docs/res/issues-overview.excalidraw
  • docs/css/custom.css
  • docs/delivery_service.rst
  • docs/extensions/artefact_enumerator.rst
  • docs/extensions/issue_replicator.rst
  • docs/model.rst
  • docs/artefact_metadata_query.rst
  • docs/res/sbom-generator.excalidraw
  • docs/local_setup.rst
  • docs/delivery-db-backup/delivery-db-backup-cronjob.excalidraw
  • docs/conf.py

Comment thread Makefile Outdated
Comment thread Makefile
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread Makefile

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We must also drop the website/documentation part from this build. Also, will you take care of purging the GitHub pages? :-)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

will do the manual clean up once merged.
pipelines are now also covered, good catch

8R0WNI3
8R0WNI3 previously approved these changes Jul 1, 2026

@8R0WNI3 8R0WNI3 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

/lgtm

zkdev and others added 8 commits July 1, 2026 10:56
There is now a central home for ODG related documentation:
-> https://github.com/open-component-model/open-delivery-gear

Contents have been migrated, therefore they can be safely removed from
this repo.
Turn the local README into a repository specific document given dev-only
instructions.

For convenience, introduce a Makefile.

Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Philipp Heil <philipp.heil@sap.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Philipp Heil <philipp.heil@sap.com>
Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
Signed-off-by: Philipp Heil (zkdev) <philipp.heil@sap.com>
@zkdev zkdev requested a review from 8R0WNI3 July 1, 2026 08:56
@zkdev

zkdev commented Jul 1, 2026

Copy link
Copy Markdown
Member Author

CI is failing as documentation cannot be build. This PR is about dropping documentation build entirely. Thus, can be safely ignored.

@zkdev zkdev merged commit b2de6df into open-component-model:master Jul 1, 2026
18 of 19 checks passed
@github-project-automation github-project-automation Bot moved this from 🔍 Review to 🍺 Done in Open Delivery Gear Jul 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ipcei Important Project of Common European Interest kind/task small task, normally part of feature or epic

Projects

Status: 🍺 Done

Development

Successfully merging this pull request may close these issues.

EPIC: Documentation and Marketing Initiative

2 participants