Skip to content

docs(ratelimit): add missing @param documentation#61736

Open
nakatani-yo wants to merge 1 commit into
nextcloud:masterfrom
nakatani-yo:fix/ratelimit-middleware-phpdoc
Open

docs(ratelimit): add missing @param documentation#61736
nakatani-yo wants to merge 1 commit into
nextcloud:masterfrom
nakatani-yo:fix/ratelimit-middleware-phpdoc

Conversation

@nakatani-yo

@nakatani-yo nakatani-yo commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR adds missing @param documentation for the $overwriteKey parameter in the readLimitFromAnnotationOrAttribute method of RateLimitingMiddleware. The parameter was present in the method signature but was not documented in the PHPDoc comment block.

Checklist

  • Code is properly formatted
  • Sign-off message is added to all commits
  • Tests are not required (documentation-only change)
  • Screenshots not applicable (backend documentation change)
  • Documentation not required (inline PHPDoc improvement)
  • Backports not required (minor documentation improvement)
  • Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
  • Milestone to be set by maintainers

AI (if applicable)

  • The content of this PR was partly or fully generated using AI

AI Tool Disclosure:

@nakatani-yo nakatani-yo requested a review from a team as a code owner July 3, 2026 03:55
@nakatani-yo nakatani-yo requested review from Altahrim, ArtificialOwl, icewind1991 and salmart-dev and removed request for a team July 3, 2026 03:55
@AndyScherzinger AndyScherzinger added 3. to review Waiting for reviews community pull requests from community labels Jul 3, 2026
@AndyScherzinger AndyScherzinger added this to the Nextcloud 35 milestone Jul 3, 2026
* @param string $methodName
* @param string $annotationName
* @param class-string<T> $attributeClass
* @param string $overwriteKey

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.

As long as strict types are used in the method signature you do not need to re-declare them in the doc blocks - as long as there is no further information like a description what this parameter is doing

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

🤷

Signed-off-by: nakatani-yo <yoshihito.nakatani@craftsman-software.com>
@AndyScherzinger AndyScherzinger force-pushed the fix/ratelimit-middleware-phpdoc branch from c970f3e to d009a21 Compare July 3, 2026 12:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3. to review Waiting for reviews community pull requests from community

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants