doc: deprecate HTTP/2 priority weights

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

Author: mcollina

doc/api/deprecations.md

@@ -3918,6 +3918,20 @@ Type: Runtime
 The `node:_tls_common` and `node:_tls_wrap` modules are deprecated as they should be considered
 an internal nodejs implementation rather than a public facing API, use `node:tls` instead.
 
+### DEP0193: `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 weights 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

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 weights 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`.
 
@@ -4929,3 +4936,4 @@ you need to implement any fall-back behavior yourself.
 [`tls.createServer()`]: tls.md#tlscreateserveroptions-secureconnectionlistener
 [`writable.writableFinished`]: stream.md#writablewritablefinished
 [error code]: #error-codes-for-rst_stream-and-goaway
+[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1