Skip to content

[https://nvbugs/7029762][docs] Link current PyTorch KV cache managers - #21437

Merged
ruodil merged 3 commits into
NVIDIA:mainfrom
ruodil:docs/7029762-kv-manager-link
Nov 3, 2026
Merged

ruodil merged 3 commits into
NVIDIA:mainfrom
ruodil:docs/7029762-kv-manager-link

Conversation

@ruodil

@ruodil ruodil commented Nov 2, 2026 •

Copy link
Copy Markdown
Collaborator

Description

The paged-attention guide links to the removed tensorrt_llm/runtime/kv_cache_manager.py implementation. Replace that destination with the current PyTorch KVCacheManager and KVCacheManagerV2 wrappers and point readers to the existing manager-selection guide. Preserve the Batch Manager source link and clarify that the V1 wrapper uses that C++ block manager, so readers can still find its allocation logic.

Fixes https://nvbugspro.nvidia.com/bug/7029762. Checked against the implementations at upstream main bdcb577a93eac5266fd32e05ef0fa944fefdfff8.

Test Coverage

Resolved all three source-link destinations, checked that the named Python classes exist with AST parsing, and verified the manager-selection page and anchor. Confirmed that V1 constructs the C++ batch-manager binding. MyST parsing, the repository's relative-link validator, spelling, applicable generic pre-commit hook checks, and git diff --check pass. Documentation-only; GPU inference and a full Sphinx build were not run.

PR Checklist

  • Reviewed the applicable contribution checklist; the change is scoped to this documentation issue and both commits have DCO sign-offs.

Dev Engineer Review

The paged KV cache guide now links to the PyTorch executor’s KVCacheManager and KVCacheManagerV2, retains the C++ block-manager reference for V1, and links to the manager-selection guide. The change removes the obsolete runtime implementation reference. No runtime behavior changes are indicated. The author reports that the link, parsing, spelling, applicable pre-commit, and diff checks passed. GPU inference and a full Sphinx build were not run.

QA Engineer Review

No test changes.

Per-File QA Perspective

  • docs/source/features/paged-attention-ifb-scheduler.md: Verify that the manager links and manager-selection guide link resolve to the intended destinations. This documentation change does not alter observable runtime behavior.

Signed-off-by: Ruodi Lu <ruodil@users.noreply.github.com>
@ruodil
ruodil requested a review from a team as a code owner November 2, 2026 09:31
@ruodil
ruodil requested review from arysef and chang-l November 2, 2026 09:31
@coderabbitai

coderabbitai Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Important

Review skipped

Review was skipped as selected files did not have any reviewable changes.

Run configuration
Commits

Reviewing files that changed from the base of the PR and between 3cefbc4 and 33d50a6.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review

No actionable comments were generated in the recent review.

Walkthrough

The paged-attention scheduler documentation now describes the PyTorch executor’s KVCacheManager and KVCacheManagerV2 integrations. It identifies V1 as wrapping the C++ block manager and links to configuration and compatibility details.

Changes

KV cache manager documentation

Layer / File(s) Summary
Document PyTorch executor integrations
docs/source/features/paged-attention-ifb-scheduler.md
The page describes the PyTorch executor’s KVCacheManager and KVCacheManagerV2 integrations. It identifies V1 as wrapping the C++ block manager and links to configuration and compatibility details.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Merge Risk: Minimal · previous review 3cefb

No actionable issue is established for this documentation update; it is mergeable after normal checks.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title names the NVBugs ID and the [docs] type, which follow the repository template. It says the PR links the current PyTorch KV cache managers, which matches the raw summary: the paged-attention …
Description check Passed The description covers the problem (the guide links to a removed runtime file), the fix (new links to the PyTorch KVCacheManager and KVCacheManagerV2 wrappers, plus a pointer to the manager-selection …
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
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.
Full details: Title check

Explanation

The title names the NVBugs ID and the [docs] type, which follow the repository template. It says the PR links the current PyTorch KV cache managers, which matches the raw summary: the paged-attention guide now links to the PyTorch KVCacheManager and KVCacheManagerV2 integrations in place of the removed runtime implementation. The title is short, specific, and identifies the main change.

Full details: Description check

Explanation

The description covers the problem (the guide links to a removed runtime file), the fix (new links to the PyTorch KVCacheManager and KVCacheManagerV2 wrappers, plus a pointer to the manager-selection guide), and the bug reference. It also includes a Test Coverage section that lists the checks run and states that GPU inference and a full Sphinx build were not run. The PR Checklist is filled in. It does not follow the template's Description heading exactly, but all required information is present.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

Finishing Touches
Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Tip

🎯 Customize your risk assessments

Guide how CodeRabbit assesses merge risk and security architecture risk. Highlight sensitive changes and explain your security boundaries using Merge Risk Instructions and Security Risk Instructions in your review settings. Security architecture risk assessments require the Advanced plan or above.

✅ Automatic approvals, with your rules

Let CodeRabbit approve pull requests once required threads are resolved, pre-merge checks pass, and your risk limits are met. Enable Automatic approvals in review settings, with overrides for teams or file paths.

CodeRabbit Verify

  • Run CodeRabbit Verify to test the changes in this pull request.
Recent review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 9e801df and 3cefbc4.

Files selected for processing: 1
  • docs/source/features/paged-attention-ifb-scheduler.md
Files skipped from review as they are similar to previous changes: 1
  • docs/source/features/paged-attention-ifb-scheduler.md

Included review availability: This review used your included allowance. Your plan provides up to 12 included reviews per hour; 11 remain after this review.

@ruodil

ruodil commented Nov 2, 2026

Copy link
Copy Markdown
Collaborator Author

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #81998 [ run ] triggered by Bot. Commit: 9e801df Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #81998 [ run ] completed with state SUCCESS. Commit: 9e801df
/LLM/main/L0_MergeRequest_PR pipeline #67637 completed with status: 'SUCCESS'

CI Report

Link to invocation

@brnguyen2 brnguyen2 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Approving — the comments below are optional touch-ups, not blockers.

@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown

Automatically added "ci: full pre-merge approved" because this PR has satisfied the required GitHub review approvals. Unresolved review conversations and other required checks remain independent merge requirements.

@ruodil
ruodil enabled auto-merge (squash) November 3, 2026 02:00
Signed-off-by: Ruodi Lu <ruodil@users.noreply.github.com>
@ruodil

ruodil commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator Author

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #82148 [ run ] triggered by Bot. Commit: 3cefbc4 Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #82148 [ run ] completed with state SUCCESS. Commit: 3cefbc4
/LLM/main/L0_MergeRequest_PR pipeline #67778 completed with status: 'SUCCESS'

CI Report

Link to invocation

@ruodil

ruodil commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator Author

/bot run

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #82219 [ run ] triggered by Bot. Commit: 33d50a6 Link to invocation

@tensorrt-cicd

Copy link
Copy Markdown
Collaborator

PR_Github #82219 [ run ] completed with state SUCCESS. Commit: 33d50a6
/LLM/main/L0_MergeRequest_PR pipeline #67849 completed with status: 'SUCCESS'

CI Report

Link to invocation

@ruodil
ruodil merged commit d6ecb29 into NVIDIA:main Nov 3, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants