doc: deprecate HTTP/2 priority signaling

Signed-off-by: Matteo Collina <[email protected]>

Author: mcollina

doc/api/deprecations.md

@@ -3935,10 +3935,25 @@ The `node:_stream_duplex`, `node:_stream_passthrough`, `node:_stream_readable`,
 `node:_stream_wrap` and `node:_stream_writable` modules are deprecated as they should be considered
 an internal nodejs implementation rather than a public facing API, use `node:stream` instead.
 
+### DEP0194: `require('node:http2').Http2Stream.priority`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/58313
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+The support for priority signaling has been deprecated in the [RFC 9113][], and
+will be removed in future versions of Node.js.
+
 [DEP0142]: #dep0142-repl_builtinlibs
 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4
+[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1
 [WHATWG URL API]: url.md#the-whatwg-url-api
 [`"exports"` or `"main"` entry]: packages.md#main-entry-point-export
 [`'uncaughtException'`]: process.md#event-uncaughtexception

doc/api/http2.md

@@ -1457,6 +1457,7 @@ numeric stream identifier.
 
 <!-- YAML
 added: v8.4.0
+deprecated: REPLACEME
 -->
 
 * `options` {Object}
@@ -1474,6 +1475,9 @@ added: v8.4.0
 
 Updates the priority for this `Http2Stream` instance.
 
+The support for priority signaling has been deprecated in the [RFC 9113][], and
+will be removed in future versions of Node.js.
+
 #### `http2stream.rstCode`
 
 <!-- YAML
@@ -1583,8 +1587,11 @@ Provides miscellaneous information about the current state of the
     remotely.
   * `sumDependencyWeight` {number} The sum weight of all `Http2Stream`
     instances that depend on this `Http2Stream` as specified using
-    `PRIORITY` frames.
-  * `weight` {number} The priority weight of this `Http2Stream`.
+    `PRIORITY` frames. This has been **deprecated** in [RFC 9113][], and
+    support for it will be removed in future versions of Node.js.
+  * `weight` {number} The priority weight of this `Http2Stream`. This has been
+    **deprecated** in [RFC 9113][], and support for it will be removed in future
+    versions of Node.js.
 
 A current state of this `Http2Stream`.
 
@@ -4883,6 +4890,7 @@ you need to implement any fall-back behavior yourself.
 [RFC 7838]: https://tools.ietf.org/html/rfc7838
 [RFC 8336]: https://tools.ietf.org/html/rfc8336
 [RFC 8441]: https://tools.ietf.org/html/rfc8441
+[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1
 [Sensitive headers]: #sensitive-headers
 [`'checkContinue'`]: #event-checkcontinue
 [`'connect'`]: #event-connect