From 126045356a9d4ad623513ee52d46e0f37d3a6e3e Mon Sep 17 00:00:00 2001
From: Rafael Silva <rafael.nunu@hotmail.com>
Date: Sat, 5 Mar 2022 12:28:15 -0300
Subject: [PATCH] doc: add note about nghttp2 hd pair size

PR-URL: https://github.com/nodejs/node/pull/42172
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
---
 doc/api/http2.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/http2.md b/doc/api/http2.md
index 96b59cd11f1bd3..c184b5206139b0 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -2324,6 +2324,9 @@ changes:
     serialized, compressed block of headers. Attempts to send headers that
     exceed this limit will result in a `'frameError'` event being emitted
     and the stream being closed and destroyed.
+    While this sets the maximum allowed size to the entire block of headers,
+    `nghttp2` (the internal http2 library) has a limit of `65536`
+    for each decompressed key/value pair.
   * `paddingStrategy` {number} The strategy used for determining the amount of
     padding to use for `HEADERS` and `DATA` frames. **Default:**
     `http2.constants.PADDING_STRATEGY_NONE`. Value may be one of: