Skip to content

docs(website): rename types to UpperCamelCase#2327

Merged
morri-son merged 10 commits into
open-component-model:mainfrom
morri-son:docs/localblob-uppercamelcase
Apr 29, 2026
Merged

docs(website): rename types to UpperCamelCase#2327
morri-son merged 10 commits into
open-component-model:mainfrom
morri-son:docs/localblob-uppercamelcase

Conversation

@morri-son

@morri-son morri-son commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Rename all localBlob/v1 references to LocalBlob/v1 across website documentation (6 files)
  • Fix unversioned localBlobLocalBlob/v1 in signing concept doc
  • Add "Legacy alias: localBlob" note in the reference doc (consistent with OCIImageLayer/v1 and Helm/v1 style)
  • Remove unnecessary Helm/v1 deprecation callout (no other type has one)

What's unchanged (by design)

Dependencies

Related

@morri-son morri-son added the kind/chore chore, maintenance, etc. label Apr 17, 2026
@morri-son morri-son requested a review from a team as a code owner April 17, 2026 20:41
@netlify

netlify Bot commented Apr 17, 2026

Copy link
Copy Markdown

Deploy Preview for ocm-website ready!

Name Link
🔨 Latest commit 38c52c8
🔍 Latest deploy log https://app.netlify.com/projects/ocm-website/deploys/69f1b13ae7a79b00081cb294
😎 Deploy Preview https://deploy-preview-2327--ocm-website.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.

@coderabbitai

coderabbitai Bot commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a6c9d13c-9c54-4de6-822d-6106744c1d19

📥 Commits

Reviewing files that changed from the base of the PR and between 0ee7fd6 and 5f54109.

📒 Files selected for processing (1)
  • website/content/docs/getting-started/create-component-version.md
✅ Files skipped from review due to trivial changes (1)
  • website/content/docs/getting-started/create-component-version.md

📝 Walkthrough

Walkthrough

Documentation updates standardize the local blob access type name from localBlob to LocalBlob in multiple guides and reference pages and fix YAML indentation in an example signature block for consistent rendering.

Changes

Cohort / File(s) Summary
Basic access type renames
website/content/docs/concepts/component-identity.md, website/content/docs/how-to/download-resources-from-component-versions.md, website/content/docs/tutorials/advanced-component-constructor.md
Replaced access.type: localBlob/... with access.type: LocalBlob/... in examples.
Access type + YAML formatting
website/content/docs/concepts/signing-and-verification-concept.md, website/content/docs/getting-started/create-component-version.md, website/content/docs/reference/input-and-access-types.md
Updated examples and canonical heading to LocalBlob/v1, noted localBlob as a legacy alias, and corrected YAML indentation/nesting in the PEM signature/component descriptor examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested labels

size/m

Suggested reviewers

  • matthiasbruns
  • piotrjanik

Poem

🐰 I hopped through docs with nimble paws,

Swapped localBlob to LocalBlob because,
The YAML lined up, signatures gleamed,
Examples now tidy, just as I dreamed,
A carrot for clarity — crunchy applause!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs(website): rename types to UpperCamelCase' directly and accurately reflects the main change in the PR, which is renaming type references like localBlob to LocalBlob across documentation files.
Description check ✅ Passed The description provides a comprehensive explanation of the changes including file count, what was renamed, what was added, what was intentionally left unchanged, and relevant dependencies/related PRs.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ 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 and usage tips.

@github-actions github-actions Bot added area/documentation Documentation related size/m Medium labels Apr 17, 2026
@morri-son morri-son linked an issue Apr 17, 2026 that may be closed by this pull request
7 tasks
@Skarlso

Skarlso commented Apr 22, 2026

Copy link
Copy Markdown
Contributor

There is something wrong with the commit history here. 🤔 Can you please rebase off of a clean branch?

Comment thread website/content/docs/concepts/signing-and-verification-concept.md Outdated
@Skarlso

Skarlso commented Apr 22, 2026

Copy link
Copy Markdown
Contributor

What I'm missing is the registration of the UpperCase name. 🤔 Where is that PR?

Comment thread website/content/docs/reference/input-and-access-types.md
Comment thread website/content/docs/concepts/signing-and-verification-concept.md
Comment thread website/content/docs/how-to/transfer-helm-charts.md

@matthiasbruns matthiasbruns 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.

this pr looks mixed up and renames a lot of other types - I do not think this is a huge problem, just clean up the title & description and close duplicated PRs

@morri-son morri-son changed the title docs(website): rename localBlob type to LocalBlob UpperCamelCase docs(website): rename types to UpperCamelCase Apr 24, 2026
Update all localBlob/v1 references to LocalBlob/v1 across website
documentation. Also fix unversioned localBlob in signing concept
doc and remove unnecessary Helm/v1 deprecation callout.

The --upload-as localBlob CLI flag stays lowercase (enum value,
not a type name). Legacy content_versioned/ docs are intentionally
left unchanged.

Ref: open-component-model/ocm-project#962
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
@morri-son morri-son force-pushed the docs/localblob-uppercamelcase branch from 32d2394 to a9c15ed Compare April 24, 2026 08:22
@github-actions github-actions Bot added size/s Small and removed size/m Medium labels Apr 24, 2026
@morri-son morri-son enabled auto-merge (squash) April 24, 2026 08:23
@morri-son

Copy link
Copy Markdown
Contributor Author

@matthiasbruns
#2244 already merged, there were just minor conflicts which I resolved.

@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: 2

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

Inline comments:
In `@website/content/docs/how-to/download-resources-from-component-versions.md`:
- Line 220: Replace the incorrectly-cased access type example "LocalBlob/v1"
with the registered access type name "localBlob/v1" in the documentation example
so copy-paste matches the descriptor constants; update the example string
wherever "LocalBlob/v1" appears (e.g., the example showing access type in the
component version download docs) to use the exact registered symbol
"localBlob/v1".

In `@website/content/docs/reference/input-and-access-types.md`:
- Around line 153-156: The doc incorrectly labels `LocalBlob/v1` as canonical
and `localBlob` as legacy; update the text so `localBlob` (and `localBlob/v1`)
are shown as the canonical/registered form and `LocalBlob/v1` as the
legacy/alias, adjusting the heading and descriptive sentence for the
`LocalBlob/v1` block and the related occurrence around the other noted location
(line ~171) to reflect that `localBlob` is canonical/registered and
`LocalBlob/v1` is legacy.
🪄 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: e041faa9-dc3f-4b1b-9c72-07f1518a8936

📥 Commits

Reviewing files that changed from the base of the PR and between 2e601ca and a9c15ed.

📒 Files selected for processing (6)
  • website/content/docs/concepts/component-identity.md
  • website/content/docs/concepts/signing-and-verification-concept.md
  • website/content/docs/getting-started/create-component-version.md
  • website/content/docs/how-to/download-resources-from-component-versions.md
  • website/content/docs/reference/input-and-access-types.md
  • website/content/docs/tutorials/advanced-component-constructor.md

Comment thread website/content/docs/how-to/download-resources-from-component-versions.md Outdated
Comment thread website/content/docs/reference/input-and-access-types.md
matthiasbruns
matthiasbruns previously approved these changes Apr 24, 2026
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Comment thread website/content/docs/tutorials/advanced-component-constructor.md Outdated
Comment thread website/content/docs/getting-started/create-component-version.md Outdated
morri-son and others added 2 commits April 27, 2026 15:07
Co-authored-by: Gergely Bräutigam <skarlso777@gmail.com>
Signed-off-by: Gerald Morrison <67469729+morri-son@users.noreply.github.com>
Comment thread website/content/docs/getting-started/create-component-version.md Outdated
Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
@morri-son morri-son merged commit b742838 into open-component-model:main Apr 29, 2026
25 checks passed
ocmbot Bot pushed a commit that referenced this pull request Apr 29, 2026
## Summary

- Rename all `localBlob/v1` references to `LocalBlob/v1` across website
documentation (6 files)
- Fix unversioned `localBlob` → `LocalBlob/v1` in signing concept doc
- Add "Legacy alias: `localBlob`" note in the reference doc (consistent
with `OCIImageLayer/v1` and `Helm/v1` style)
- Remove unnecessary `Helm/v1` deprecation callout (no other type has
one)

## What's unchanged (by design)

- `--upload-as localBlob` CLI flag — this is an enum value, not a type
name
- `content_versioned/` legacy docs — intentionally frozen (same approach
as #2244)

## Dependencies

- **Depends on:** #2244 — this PR is rebased on top of
`website-upper-camel-case-types` and should be merged after #2244

## Related

- Part of open-component-model/ocm-project#962
- Related code PRs: #2323 (descriptor), #2324 (constructor), #2325
(cli), #2326 (controller)

---------

Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Co-authored-by: Gerald Morrison (SAP) <gerald.morrison@sap.com> b742838
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Documentation related kind/chore chore, maintenance, etc. size/s Small

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants