Skip to content

docs(release): fix broken links and PR refs in v1.4.0 changelog - #2693

Merged
Andrei Kvapil (kvaps) merged 1 commit into
mainfrom
daniil/fix-v140-changelog-links
May 20, 2026
Merged

Andrei Kvapil (kvaps) merged 1 commit into
mainfrom
daniil/fix-v140-changelog-links

Conversation

@myasnikovdaniil

@myasnikovdaniil myasnikovdaniil commented May 20, 2026 •

Copy link
Copy Markdown
Contributor

What this PR does

Follow-up to #2675. Fixes four broken references in docs/changelogs/v1.4.0.md that were caught by re-verifying every link in the merged changelog:

Where Was Now
Resource Presets doc link (Feature Highlights) cozystack.io/docs/operations/resource-presets/ (404) cozystack.io/docs/v1.4/guides/resource-management/
HAMi doc link (Feature Highlights) cozystack.io/docs/operations/kubernetes/hami/ (404) cozystack.io/docs/v1.4/kubernetes/gpu-sharing/
Upgrade notes — resource presets PR ref #2426 (feat(monitoring): upgrade victoria-metrics-operator) #2607 (feat(apps): instance-type resource presets)
Upgrade notes — postgres parameters PR ref #2475 (unrelated open issue about bundle YAML) #2466 (feat(postgres)!: support all PostgreSQL configuration parameters)

The Feature Highlights / Major Features sections already cited #2607 and #2466 correctly; only the Upgrade Notes section pointed at the wrong PR numbers.

Release note

NONE

Summary by CodeRabbit

  • Documentation
    • Updated changelog documentation links to reflect new resource management guides location.
    • Refreshed HAMi compatibility references to point to current GPU-sharing documentation.
    • Updated related PR references in upgrade notes for accuracy.

Review Change Stack

- Resource Presets doc URL: /docs/operations/resource-presets/ → /docs/v1.4/guides/resource-management/ (was 404)
- HAMi doc URL: /docs/operations/kubernetes/hami/ → /docs/v1.4/kubernetes/gpu-sharing/ (was 404)
- Upgrade-notes PR ref for presets: #2426 → #2607
- Upgrade-notes PR ref for postgres parameters: #2475 → #2466

Assisted-By: Claude <[email protected]>
Signed-off-by: Myasnikov Daniil <[email protected]>
@gemini-code-assist

Copy link
Copy Markdown
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 addresses inaccuracies in the v1.4.0 release documentation. It resolves broken hyperlinks to external documentation and updates references to specific pull requests in the upgrade notes to ensure users are directed to the correct implementation details.

Highlights

  • Documentation Fixes: Corrected broken documentation links for Resource Presets and HAMi in the v1.4.0 changelog.
  • Reference Updates: Updated incorrect pull request references in the Upgrade Notes section for resource presets and PostgreSQL parameters.
New Features

🧠 You can now enable Memory (public preview) 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.

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 (@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 the 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 counterproductive. You can react with 👍 and 👎 on Gemini (@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.

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. ↩

@github-actions github-actions Bot added the size/XS This PR changes 0-9 lines, ignoring generated files label May 20, 2026
@coderabbitai

coderabbitai Bot commented May 20, 2026 •

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 20a21124-0591-4557-88ba-f224cb356d6c

📥 Commits

Reviewing files that changed from the base of the PR and between 4bf1cdc and 94943bd.

📒 Files selected for processing (1)
  • docs/changelogs/v1.4.0.md

📝 Walkthrough

Walkthrough

The v1.4.0 changelog is updated with corrected documentation links pointing to v1.4 guides and refreshed PR numbers in the Upgrade Notes section, while preserving all described behaviors and semantics.

Changes

v1.4.0 Changelog Reference Updates

Layer / File(s) Summary
Changelog documentation links and PR references
docs/changelogs/v1.4.0.md
Resource Presets guidance link updated to /docs/v1.4/guides/resource-management/, HAMi compatibility documentation link updated to v1.4 GPU-sharing path, and Upgrade Notes PR references refreshed for Resource Presets legacy alias and PostgreSQL parameter behaviors.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • cozystack/cozystack#2675: Updates the same v1.4.0 changelog file with documentation link and reference corrections for consistency across the release notes.

Suggested labels

kind/documentation, size/S, area/release

Suggested reviewers

  • lexfrei
  • androndo
  • sircthulhu
  • kvaps
  • lllamnyp
  • IvanHunters

Poem

🐰 The changelog sparkles with links so bright,
Pointing to guides in their new home, just right—
PR numbers refreshed, the record is clean,
Version one-point-four's the best ever seen! ✨

🚥 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 accurately summarizes the main change: fixing broken links and PR references in the v1.4.0 changelog, which matches the actual content of the changeset.
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
  • Commit unit tests in branch daniil/fix-v140-changelog-links

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/release Issues or PRs related to release tooling (changelog, backport, release pipeline) kind/documentation Categorizes issue or PR as related to documentation labels May 20, 2026

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the v1.4.0 changelog by correcting broken documentation links and fixing incorrect PR references for resource presets and PostgreSQL parameter type-checking. Feedback was provided regarding the PR title, which uses an invalid scope ('release') according to the repository's Conventional Commits style guide; the reviewer suggested using a valid scope such as 'docs' for consistency.

Comment thread docs/changelogs/v1.4.0.md
Each series ships eight sizes (`nano` → `4xlarge`). The seven legacy flat names (`nano` … `2xlarge`) are kept as deprecated aliases that map 1:1 by CPU and memory, so `helm template ... --set resourcesPreset=small` still renders `1 CPU / 512Mi` exactly as before. **Migration 39** walks every `HelmRelease.spec.values` and every app CR under `apps.cozystack.io/v1alpha1` and rewrites legacy values to their instance-type equivalents (`small → t1.small`, `medium → c1.small`, etc); the migration is idempotent and dry-runnable via `MIGRATION_DRY_RUN=1`. The `cozystack-api` emits deprecation warnings on every `Create`/`Update` against an app CR that still carries a legacy value, naming the JSON path and the 1:1 replacement.

Operators see no behavioural change on upgrade — defaults preserve resources exactly. New deployments get the richer taxonomy and can select an explicit CPU/memory ratio per workload. See [Resource Presets](https://cozystack.io/docs/operations/resource-presets/) for the full size matrix ([**@lexfrei**](https://github.com/lexfrei) and [**@matthieu-robin**](https://github.com/matthieu-robin) in #2607).
Operators see no behavioural change on upgrade — defaults preserve resources exactly. New deployments get the richer taxonomy and can select an explicit CPU/memory ratio per workload. See [Resource Presets](https://cozystack.io/docs/v1.4/guides/resource-management/) for the full size matrix ([**@lexfrei**](https://github.com/lexfrei) and [**@matthieu-robin**](https://github.com/matthieu-robin) in #2607).

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.

low

The PR title docs(release): ... does not fully align with the repository's Conventional Commits style guide. While docs is a valid type, release is not a listed scope.

For consistency with the project's contribution guidelines, please consider updating the title to use a valid scope, such as docs. For example: docs(docs): fix broken links and PR refs in v1.4.0 changelog.

References
  1. Commits must follow the Conventional Commits format type(scope): brief description. The scope must be one of the valid scopes defined in the repository style guide (lines 40-46). The scope release is not in this list, while docs is a valid meta-scope. (link)

@kvaps
Andrei Kvapil (kvaps) merged commit b20d542 into main May 20, 2026
10 checks passed
@kvaps
Andrei Kvapil (kvaps) deleted the daniil/fix-v140-changelog-links branch May 20, 2026 10:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/release Issues or PRs related to release tooling (changelog, backport, release pipeline) kind/documentation Categorizes issue or PR as related to documentation size/XS This PR changes 0-9 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants