Skip to content

docs(requestcontrol): correct FlowControlAdmissionController.Admit docstring#13

Open
chethanuk wants to merge 1 commit into
mainfrom
fix/issue-1934-flow-control-flowcontroladmissioncontroller-does-not-shed
Open

docs(requestcontrol): correct FlowControlAdmissionController.Admit docstring#13
chethanuk wants to merge 1 commit into
mainfrom
fix/issue-1934-flow-control-flowcontroladmissioncontroller-does-not-shed

Conversation

@chethanuk

@chethanuk chethanuk commented Jul 12, 2026

Copy link
Copy Markdown
Owner

User description

Description

The docstring for FlowControlAdmissionController.Admit previously claimed that it checked for saturation on sheddable requests first, then deferred to Flow Control. This was incorrect; the implementation only defers via EnqueueAndWait, and saturation shedding is handled downstream by the dispatch cycle.

This PR updates the docstring to accurately describe the implemented behavior. No runtime changes are made.

Fixes llm-d#1934

Verification

  • Verified pkg/epp/requestcontrol/admission.go correctly documents that FlowControlAdmissionController.Admit defers the decision via EnqueueAndWait and that saturation-based shedding is handled downstream.
  • No behavioral changes, so tests are not strictly needed.

CodeAnt-AI Description

Correct the admission controller docs to match how requests are actually handled

What Changed

  • Updated the admission controller description to say it always hands the decision to Flow Control
  • Clarified that saturation-based shedding happens later during dispatch, not during admission
  • No runtime behavior changed

Impact

✅ Clearer admission behavior docs
✅ Fewer mistaken expectations about request shedding
✅ Easier maintenance of request-control docs

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

@codeant-ai

codeant-ai Bot commented Jul 12, 2026

Copy link
Copy Markdown

CodeAnt AI is reviewing your PR.

@codeant-ai

codeant-ai Bot commented Jul 12, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@coderabbitai

coderabbitai Bot commented Jul 12, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@chethanuk, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 55 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7a96a043-6d36-458c-87d3-bee57bc50c5b

📥 Commits

Reviewing files that changed from the base of the PR and between fb5486a and 008301e.

📒 Files selected for processing (1)
  • pkg/epp/requestcontrol/admission.go
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/issue-1934-flow-control-flowcontroladmissioncontroller-does-not-shed

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.

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

Code Review

This pull request updates the documentation for the Admit function in admission.go to clarify how saturation-based shedding is handled downstream. It also introduces a placeholder comment in admission_test.go which should be removed as it appears to be a leftover testing artifact.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment on lines 1 to 3
// Test addition for Path C doc-only change

/*

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

This comment appears to be a leftover placeholder or testing artifact (Path C doc-only change) and is not needed in the final codebase. It should be removed.

Suggested change
// Test addition for Path C doc-only change
/*
/*

@codeant-ai codeant-ai Bot added the size:XS This PR changes 0-9 lines, ignoring generated files label Jul 12, 2026
…cstring

The docstring for FlowControlAdmissionController.Admit previously claimed
that it checked for saturation on sheddable requests first, then deferred
to Flow Control. This was incorrect; the implementation only defers via
EnqueueAndWait, and saturation shedding is handled downstream by the
dispatch cycle.

Update the docstring to accurately describe the implemented behavior.
No runtime changes are made.

Fixes llm-d#1934

Signed-off-by: ChethanUK <chethanuk@outlook.com>
@chethanuk
chethanuk force-pushed the fix/issue-1934-flow-control-flowcontroladmissioncontroller-does-not-shed branch from d2a8a5c to 008301e Compare July 12, 2026 22:46
@@ -1,3 +1,5 @@
// Test addition for Path C doc-only change

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggestion: The added comment is factually incorrect because this change does not add a test case; keeping misleading comments in test files can cause confusion during future debugging and reviews. Update the comment to describe the actual change (or remove it). [comment mismatch]

Severity Level: Minor 🧹
- ⚠️ Suggestion addresses non-issue; comment is harmless metadata.
- ⚠️ Test behavior unchanged; comment unused by tooling.
Steps of Reproduction ✅
1. Open `pkg/epp/requestcontrol/admission_test.go` and observe the header comment at line
1: `// Test addition for Path C doc-only change` (verified via Read tool).

2. Scroll through the same file and see that multiple test functions already exist (e.g.,
`TestLegacyAdmissionController_Admit` starting at line 69 and
`TestFlowControlAdmissionController_Admit` starting at line 195), none of which were
introduced by this PR.

3. Note that the current PR change only adds the single comment line and does not add or
modify any test logic in this file, so there is no behavioral discrepancy between tests
and implementation.

4. Since the comment is not referenced by any tooling or code paths and merely reflects
commit metadata, any slight mismatch between wording and actual change history is a
cosmetic/non-functional issue, making this suggestion effectively frivolous from a runtime
perspective.

Fix in Cursor Fix in VSCode Claude

(Use Cmd/Ctrl + Click for best experience)

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** pkg/epp/requestcontrol/admission_test.go
**Line:** 1:1
**Comment:**
	*Comment Mismatch: The added comment is factually incorrect because this change does not add a test case; keeping misleading comments in test files can cause confusion during future debugging and reviews. Update the comment to describe the actual change (or remove it).

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

@codeant-ai

codeant-ai Bot commented Jul 12, 2026

Copy link
Copy Markdown

CodeAnt AI finished reviewing your PR.

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

Labels

size/XS size:XS This PR changes 0-9 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Flow Control] FlowControlAdmissionController does not shed sheddable requests at admission

1 participant