Skip to content

docs(variants): replace bundles with variants, add default and isp-full-generic#433

Merged
kvaps merged 1 commit intomainfrom
docs/replace-bundles-with-variants
Feb 26, 2026
Merged

docs(variants): replace bundles with variants, add default and isp-full-generic#433
kvaps merged 1 commit intomainfrom
docs/replace-bundles-with-variants

Conversation

@kvaps
Copy link
Member

@kvaps kvaps commented Feb 26, 2026

Summary

  • Rename "Bundles" documentation to "Variants" to match the current Cozystack terminology
  • Remove deprecated variants: iaas-full, distro-full, distro-hosted
  • Add new variants: default (PackageSources only, manual package management via cozypkg) and isp-full-generic (full PaaS/IaaS on k3s, kubeadm, RKE2)
  • Update all cross-references across the documentation

Test plan

  • Hugo builds without errors
  • Verify all internal links resolve correctly on the live site
  • Check that old /docs/v1/operations/configuration/bundles/ URL redirects properly

Summary by CodeRabbit

  • Documentation
    • Updated configuration terminology from bundles to variants across all documentation files.
    • Added comprehensive Variants reference documentation with configuration details, component matrices, and usage guidelines.
    • Removed outdated Bundles documentation.
    • Updated all cross-references and links throughout documentation to point to variants.

…ll-generic

Rename "Bundles" documentation to "Variants" to match current Cozystack
terminology. Remove deprecated variants (iaas-full, distro-full,
distro-hosted). Add new variants: default (PackageSources only) and
isp-full-generic (full PaaS/IaaS on k3s, kubeadm, RKE2). Update all
cross-references across the documentation.

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

netlify bot commented Feb 26, 2026

Deploy Preview for cozystack ready!

Name Link
🔨 Latest commit 0e55a89
🔍 Latest deploy log https://app.netlify.com/projects/cozystack/deploys/69a08544a12f620008cacabf
😎 Deploy Preview https://deploy-preview-433--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 26, 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 f2b4349 and 0e55a89.

📒 Files selected for processing (9)
  • content/en/docs/v1/development.md
  • content/en/docs/v1/getting-started/install-cozystack.md
  • content/en/docs/v1/guides/concepts.md
  • content/en/docs/v1/install/cozystack/_index.md
  • content/en/docs/v1/introduction/_index.md
  • content/en/docs/v1/operations/configuration/_index.md
  • content/en/docs/v1/operations/configuration/bundles.md
  • content/en/docs/v1/operations/configuration/platform-package.md
  • content/en/docs/v1/operations/configuration/variants.md

📝 Walkthrough

Walkthrough

This pull request refactors documentation terminology across multiple files, replacing "bundles" with "variants" throughout the Cozystack documentation. A new comprehensive variants documentation file is created, the legacy bundles documentation is removed, and various reference links and content descriptions are updated accordingly.

Changes

Cohort / File(s) Summary
Documentation Links & Terminology Updates
content/en/docs/v1/development.md, content/en/docs/v1/getting-started/install-cozystack.md, content/en/docs/v1/guides/concepts.md, content/en/docs/v1/install/cozystack/_index.md, content/en/docs/v1/introduction/_index.md, content/en/docs/v1/operations/configuration/_index.md, content/en/docs/v1/operations/configuration/platform-package.md
Updates link targets and content references from bundles documentation path to variants path; replaces "bundles" terminology with "variants" in descriptions and section headings.
Variants Documentation
content/en/docs/v1/operations/configuration/variants.md
New comprehensive documentation file covering Cozystack variants, including overview table, per-variant sections (default, isp-full, isp-full-generic, isp-hosted), example configurations, and component inclusion details.
Removed Documentation
content/en/docs/v1/operations/configuration/bundles.md
Deleted legacy bundles documentation file, eliminating all related content, references, and navigation aliases.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Bundles transformed to variants bright,
Links renewed with terminology's light,
Old docs fade, new docs take the stage,
Documentation turns a cleaner page! 🌟

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/replace-bundles-with-variants

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 @kvaps, 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 significantly refactors the Cozystack documentation regarding system configurations. The primary goal is to standardize terminology from 'Bundles' to 'Variants' and to update the available configuration options. This change improves clarity and accuracy for users seeking to understand and deploy Cozystack, by reflecting the most current and supported ways to configure the platform.

Highlights

  • Documentation Terminology Update: The documentation has been updated to consistently use the term "Variants" instead of "Bundles" to align with current Cozystack terminology across all relevant guides and references.
  • Variant Management: Deprecated variants, specifically iaas-full, distro-full, and distro-hosted, have been removed from the documentation. Concurrently, two new variants, default and isp-full-generic, have been introduced to provide more flexible configuration options.
  • Cross-Reference Updates: All internal links and cross-references within the documentation have been meticulously updated to reflect the new "Variants" terminology and the updated file structure.

🧠 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/development.md
    • Updated the reference link for 'variant' from 'bundles' to 'variants'.
  • content/en/docs/v1/getting-started/install-cozystack.md
    • Updated the reference link for 'Cozystack Bundles reference' to 'Cozystack Variants reference'.
  • content/en/docs/v1/guides/concepts.md
    • Updated the document description to mention 'variants' instead of 'bundles'.
    • Replaced 'bundles' with 'variants' in the core concepts section.
    • Renamed the 'Bundles' section title to 'Variants' and updated its introductory text and reference link.
  • content/en/docs/v1/install/cozystack/_index.md
    • Updated reference links from 'Cozystack variant' and 'bundles overview and comparison' to point to the new 'variants' documentation.
  • content/en/docs/v1/introduction/_index.md
    • Updated the reference link from 'Cozystack bundle' to 'Cozystack variant'.
  • content/en/docs/v1/operations/configuration/_index.md
    • Updated the document description to include 'variants' instead of 'bundles'.
  • content/en/docs/v1/operations/configuration/bundles.md
    • Removed the entire file, as its content has been superseded by the new variants documentation.
  • content/en/docs/v1/operations/configuration/platform-package.md
    • Updated the reference link for 'Cozystack variant' from 'bundles' to 'variants'.
    • Removed 'distro-full' from the list of available options for bundles.system.variant.
  • content/en/docs/v1/operations/configuration/variants.md
    • Added a new documentation file detailing Cozystack variants, including an overview, comparison table, and specific sections for default, isp-full, isp-full-generic, and isp-hosted variants.
    • Included aliases to ensure old 'bundles' URLs redirect to this new 'variants' page.
Activity
  • No specific review comments or activity have been recorded for 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.

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 effectively renames "Bundles" to "Variants" across the documentation, aligning with the updated Cozystack terminology. It successfully removes deprecated variants (iaas-full, distro-full, distro-hosted) and introduces new ones (default, isp-full-generic), with all cross-references updated accordingly. The changes are consistent and well-executed, improving clarity and accuracy of the documentation.

@kvaps kvaps marked this pull request as ready for review February 26, 2026 18:05
@kvaps kvaps requested a review from lllamnyp as a code owner February 26, 2026 18:05
@kvaps kvaps merged commit 38f3e24 into main Feb 26, 2026
6 checks passed
@kvaps kvaps deleted the docs/replace-bundles-with-variants branch February 26, 2026 18:06
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