Skip to content

fix(docs): correct component values override instructions#436

Merged
kvaps merged 1 commit intomainfrom
fix/component-values-override-docs
Feb 28, 2026
Merged

fix(docs): correct component values override instructions#436
kvaps merged 1 commit intomainfrom
fix/component-values-override-docs

Conversation

@kvaps
Copy link
Member

@kvaps kvaps commented Feb 28, 2026

What this PR does

Fixes the "Overwriting Component Parameters" section in the components
reference. The previous instructions incorrectly showed overriding
component values through the Platform Package. The correct approach is
to modify the specific Package resource directly (e.g. cozystack.metallb)
and specify values in its spec.components section.

The values structure follows the values.yaml of the respective system
chart in the Cozystack repository.

Updated the example to show enabling FRR-K8s mode for MetalLB with a
link to the system chart values.

Summary by CodeRabbit

  • Documentation
    • Updated component configuration guidance with clearer examples for overriding component parameters.
    • Enhanced documentation with improved examples for enabling and disabling components, including MetalLB and alternative networking options.

The previous instructions incorrectly showed overriding component
values through the Platform Package. The correct approach is to modify
the specific Package resource directly (e.g. cozystack.metallb) and
specify values in its spec.components section.

Updated the example to show enabling FRR-K8s mode for MetalLB and added
a link to the system chart values in the Cozystack repository.

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Andrei Kvapil <kvapss@gmail.com>
@netlify
Copy link

netlify bot commented Feb 28, 2026

Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit cd20130
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/69a2cc9b942ed2000829fdd7
😎 Deploy Preview https://deploy-preview-436--cozystack.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
Copy link
Contributor

coderabbitai bot commented Feb 28, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fc2994b and cd20130.

📒 Files selected for processing (1)
  • content/en/docs/v1/operations/configuration/components.md

📝 Walkthrough

Walkthrough

Documentation update clarifying how to override component parameters by modifying the corresponding Package resource. Examples revised to reference MetalLB-specific configuration instead of the platform package, with added guidance on enabling/disabling components via bundles.

Changes

Cohort / File(s) Summary
Documentation - Configuration Components
content/en/docs/v1/operations/configuration/components.md
Updated guidance for overriding component parameters to reference Package resources and spec.components. Replaced platform package references (cozystack.cozystack-platform) with metallb package references (cozystack.metallb). Revised YAML examples to show FRR-K8s mode enablement and reorganized component mappings. Added bundle-based examples and Hetzner/RobotLB use case.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hop through the docs with MetalLB in sight,
Package references now shine so bright!
FRR-K8s enabled, examples so clear,
Configuration wisdom for those drawing near.
*wiggles nose at better documentation*

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix/component-values-override-docs

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.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request improves the accuracy of the documentation for Cozystack, specifically addressing how users should override component parameters. It clarifies that modifications should target individual Package resources directly, rather than the overarching Platform Package, and provides a practical example to guide users through the correct configuration process.

Highlights

  • Documentation Correction: Corrected the "Overwriting Component Parameters" section to accurately describe how to override component values by modifying specific Package resources directly, rather than through the Platform Package.
  • Example Update: Revised the example YAML configuration to demonstrate enabling FRR-K8s mode for MetalLB, including a link to its system chart values.yaml.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • content/en/docs/v1/operations/configuration/components.md
    • Updated instructions for overriding component parameters.
    • Revised the example YAML configuration to use cozystack.metallb and enable FRR-K8s.
    • Added a link to the system chart values.yaml for understanding available parameters.
Activity
  • No human activity has been recorded on this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@kvaps kvaps marked this pull request as ready for review February 28, 2026 11:08
@kvaps kvaps requested a review from lllamnyp as a code owner February 28, 2026 11:08
@kvaps kvaps merged commit ee24d66 into main Feb 28, 2026
6 checks passed
@kvaps kvaps deleted the fix/component-values-override-docs branch February 28, 2026 11:08
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request updates the documentation for overriding component parameters. The instructions have been corrected to show that overrides should be applied to the specific component's Package resource, not the main Platform Package. The example has also been updated to be more focused and now demonstrates enabling FRR-K8s for MetalLB. The changes improve the clarity and correctness of the documentation. I have one suggestion to make a link in the documentation less ambiguous.

Comment on lines +14 to +16
in the `spec.components` section. The values structure follows the
[values.yaml](https://github.com/cozystack/cozystack/tree/main/packages/system)
of the respective system chart in the Cozystack repository.
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The link on line 15 is slightly misleading as the link text values.yaml suggests a file, but the URL points to a directory. This could be confusing for users. Consider rephrasing to improve clarity.

Suggested change
in the `spec.components` section. The values structure follows the
[values.yaml](https://github.com/cozystack/cozystack/tree/main/packages/system)
of the respective system chart in the Cozystack repository.
in the `spec.components` section. The values structure follows the `values.yaml`
of the respective system chart, which can be found in the repository's
[system packages directory](https://github.com/cozystack/cozystack/tree/main/packages/system).

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant