Changeset 55646 for trunk/src/wp-includes/class-wp-http-curl.php

Timestamp:

04/11/2023 10:04:58 PM (3 years ago)

Author:

audrasjb

Message:

Docs: Revise comments using “we” in various docblocks.

This updates some inline comments to better match the guidelines and recommendations set forth in the make/core and make/docs handbooks:

In general, use second person in your documentation. Second person depicts a friendly tone, with a perfect focus on the reader. In addition to this, directly addressing the reader helps avoid passive voice; thereby preventing unwanted confusion. The word “we” should be avoided (...) unless its made very clear which group is speaking.

References:

• ​Style Guide: Grammatical person
• ​Handbooks & HelpHub Style and Formatting Guide
• ​Post & Comment Guidelines: Style and Substance

Follow-up to [2176], [3430], [4676], [6009], [7991], [12688], [12762], [26008], [28978], [44488], [44962], [51979], [53131], [53132], [53156], [53131], [54200], [54866].

Props majaloncar, leamcaleese, annebovelett.
Fixes #57052.

File:

• trunk/src/wp-includes/class-wp-http-curl.php (modified) (3 diffs)

trunk/src/wp-includes/class-wp-http-curl.php

@@ -329 +329 @@
      * Grabs the headers of the cURL request.
      *
-     * Each header is sent individually to this callback, so we append to the `$header` property
-     * for temporary storage
+     * Each header is sent individually to this callback, and is appended to the `$header` property
+     * for temporary storage.
      *
      * @since 3.2.0
@@ -346 +346 @@
      * Grabs the body of the cURL request.
      *
-     * The contents of the document are passed in chunks, so we append to the `$body`
+     * The contents of the document are passed in chunks, and are appended to the `$body`
      * property for temporary storage. Returning a length shorter than the length of
      * `$data` passed in will cause cURL to abort the request with `CURLE_WRITE_ERROR`.
@@ -352 +352 @@
      * @since 3.6.0
      *
-     * @param resource $handle  cURL handle.
-     * @param string   $data    cURL request body.
+     * @param resource $handle cURL handle.
+     * @param string   $data   cURL request body.
      * @return int Total bytes of data written.
      */