Improve & document WP-CLI hook usage

[swissspidy]

Relies on wp-cli/wp-cli-tests#344

Summary by CodeRabbit

• Documentation
  • Expanded developer documentation for the REST request arguments hook, including callback parameters.
  • Clarified how request arguments can be customized without changing request behavior.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7e8794a7-c3ce-43d3-90db-4718db879a1e

📥 Commits

Reviewing files that changed from the base of the PR and between d222ade and 730e3a5.

📒 Files selected for processing (1)

• inc/RestCommand.php

---

📝 Walkthrough

Walkthrough

The RestCommand PHPDoc now documents the restful_http_request_args hook, its request argument structure, and the RestCommand callback context. Request-building logic remains unchanged.

Changes

REST request documentation

Layer / File(s)	Summary
Document request arguments hook inc/RestCommand.php	Expanded PHPDoc describes the restful_http_request_args hook and its $request_args and RestCommand $command callback parameters.

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

Suggested reviewers: brianhenryie

🚥 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 matches the change: it documents WP-CLI hook usage and improves hook-related docs.
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.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/do-hook

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!