Skip to content

[Doc] Fix group numbering in Case 3 of hybrid_kv_cache_manager.md - #52160

Merged
hmellor merged 1 commit into
vllm-project:mainfrom
qwerqwerqwe8688-jpg:docs/fix-hybrid-doc-group-numbering
Aug 19, 2026
Merged

[Doc] Fix group numbering in Case 3 of hybrid_kv_cache_manager.md#52160
hmellor merged 1 commit into
vllm-project:mainfrom
qwerqwerqwe8688-jpg:docs/fix-hybrid-doc-group-numbering

Conversation

@qwerqwerqwe8688-jpg

Copy link
Copy Markdown
Contributor

Purpose

Fix a self-inconsistent group numbering in docs/design/hybrid_kv_cache_manager.md Case 3 (lines 111-124).

The doc says Gemma-3-27b has 52 sliding-window layers, but lists:

  • Group 6: 10 sliding window attention layers (sw.40 - sw.49)
  • Group 7: 2 sliding window attention layers (sw.50 - sw.51) and 8 padding layers

With group_size=10, 52 sw layers end at Group 6 (sw.50-51 + 8 padding); there is no Group 7. sw.40-49 belongs to Group 5.

Renumbered to: Group 5 = sw.40-49, Group 6 = sw.50-51 + 8 padding (7 groups total, Group 0-6).

Why not duplicating an existing PR

Searched gh issue list / gh pr list for "hybrid_kv_cache_manager": no open issue or PR. Pure documentation fix.

Test Plan

  • pre-commit run markdownlint-cli2 --files docs/design/hybrid_kv_cache_manager.md

Test Result

Local environment has no pre-commit/Python; relying on CI check.


AI Assistance

This PR was drafted with AI assistance; the human submitter reviewed every changed line. Co-authored-by: deepseek-v4-flash

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Claude Code Review

This pull request is from a fork — automated review is disabled. A repository maintainer can comment @claude review to run a one-time review.

@mergify

mergify Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Documentation preview: https://vllm--52160.org.readthedocs.build/en/52160/

@mergify mergify Bot added the documentation Improvements or additions to documentation label Aug 13, 2026
@qwerqwerqwe8688-jpg

Copy link
Copy Markdown
Contributor Author

Hi @hmellor! This is a small documentation fix for hybrid_kv_cache_manager.md — correcting the group numbering in Case 3. Could you take a look when you have a moment? Thanks!

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

We are only saving one line with the ... let's just write all 6 groups explicitly

@qwerqwerqwe8688-jpg

Copy link
Copy Markdown
Contributor Author

We are only saving one line with the ... let's just write all 6 groups explicitly

@hmellor, thanks for the quick review! You're right – using ... only saves one line and makes the grouping less clear. Will push the update in a moment.

Explicitly list all groups (Group 0-6) instead of using '...' in the Case 3 example.

With group_size=10, 52 sliding-window layers end at Group 5 (sw.50-51 + 8 padding); the doc previously misnumbered sw.40-49 as Group 6 and added a spurious Group 7. Now all groups are written out for clarity.

Co-authored-by: deepseek-v4-flash
Signed-off-by: qwerqwerqwe8688-jpg <xuuuuu2021@163.com>
@qwerqwerqwe8688-jpg
qwerqwerqwe8688-jpg force-pushed the docs/fix-hybrid-doc-group-numbering branch from eb1f305 to 09dc0ef Compare August 19, 2026 10:51
@hmellor

hmellor commented Aug 19, 2026

Copy link
Copy Markdown
Member

/ci run

@hmellor hmellor added the verified Run pre-commit for new contributors without triggering other tests label Aug 19, 2026
@github-actions

Copy link
Copy Markdown

✅ Triggered Buildkite CI #84590 for commit 09dc0ef71e62.

@hmellor
hmellor enabled auto-merge (squash) August 19, 2026 11:37
@hmellor
hmellor merged commit 58302b4 into vllm-project:main Aug 19, 2026
11 of 16 checks passed
@github-actions github-actions Bot added the ready ONLY add when PR is ready to merge/full CI is needed label Aug 19, 2026
zyp2014 pushed a commit to zyp2014/vllm that referenced this pull request Aug 21, 2026
wyettzeng pushed a commit to wyettzeng/vllm that referenced this pull request Aug 21, 2026
…lm-project#52160)

Signed-off-by: qwerqwerqwe8688-jpg <xuuuuu2021@163.com>
Signed-off-by: Wyett <wyettzeng@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ready ONLY add when PR is ready to merge/full CI is needed verified Run pre-commit for new contributors without triggering other tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants