diff --git a/doc/api/http2.md b/doc/api/http2.md
index 11d8435bfa51e8..1720ce6fd5cf49 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -2055,7 +2055,8 @@ changes:
     queued to be sent, and unacknowledged `PING` and `SETTINGS` frames are all
     counted towards the current limit. **Default:** `10`.
   * `maxHeaderListPairs` {number} Sets the maximum number of header entries.
-    This is similar to `HTTP/1`'s `maxHeadersCount`. The minimum value is `4`.
+    This is similar to `http.Server#maxHeadersCount` (or
+    `http.ClientRequest#maxHeadersCount`). The minimum value is `4`.
     **Default:** `128`.
   * `maxOutstandingPings` {number} Sets the maximum number of outstanding,
     unacknowledged pings. **Default:** `10`.
@@ -2195,7 +2196,8 @@ changes:
     queued to be sent, and unacknowledged `PING` and `SETTINGS` frames are all
     counted towards the current limit. **Default:** `10`.
   * `maxHeaderListPairs` {number} Sets the maximum number of header entries.
-    This is similar to `HTTP/1`'s `maxHeadersCount`. The minimum value is `4`.
+    This is similar to `http.Server#maxHeadersCount` (or
+    `http.ClientRequest#maxHeadersCount`). The minimum value is `4`.
     **Default:** `128`.
   * `maxOutstandingPings` {number} Sets the maximum number of outstanding,
     unacknowledged pings. **Default:** `10`.
@@ -2309,7 +2311,8 @@ changes:
     queued to be sent, and unacknowledged `PING` and `SETTINGS` frames are all
     counted towards the current limit. **Default:** `10`.
   * `maxHeaderListPairs` {number} Sets the maximum number of header entries.
-    This is similar to `HTTP/1`'s `maxHeadersCount`. The minimum value is `1`.
+    This is similar to `http.Server#maxHeadersCount` (or
+    `http.ClientRequest#maxHeadersCount`). The minimum value is `1`.
     **Default:** `128`.
   * `maxOutstandingPings` {number} Sets the maximum number of outstanding,
     unacknowledged pings. **Default:** `10`.