From a40ef9d51a6dfa7bc15758fb807ce4fd537eda0c Mon Sep 17 00:00:00 2001
From: Antoine du Hamel <duhamelantoine1995@gmail.com>
Date: Fri, 28 Aug 2026 15:59:10 +0200
Subject: [PATCH] doc: clarify DEP0207 scope

Signed-off-by: Antoine du Hamel <duhamelantoine1995@gmail.com>
---
 doc/api/deprecations.md            |  2 +-
 doc/api/http2.md                   | 14 ++++++++++----
 test/doctool/test-doc-api-json.mjs |  2 +-
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 3abfd75ce8de..10fa3964372f 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -4647,7 +4647,7 @@ throwing an error. This behavior is inconsistent with `hash.digest()` and
 may lead to subtle bugs. Calling `hmac.digest()` on a finalized `Hmac` instance
 will throw an error in a future version.
 
-### DEP0207: `.aborted` property and `'aborted'` event in `http2`
+### DEP0207: `.aborted` property and `'aborted'` event in `node:http2`
 
 <!-- YAML
 changes:
diff --git a/doc/api/http2.md b/doc/api/http2.md
index f5dbe67fc514..fe31f970b2f4 100644
--- a/doc/api/http2.md
+++ b/doc/api/http2.md
@@ -1275,10 +1275,7 @@ destroyed.
 
 <!-- YAML
 added: v8.4.0
-changes:
-  - version: REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/63249
-    description: Documentation-only deprecation.
+deprecated: REPLACEME
 -->
 
 > Stability: 0 - Deprecated. Use `'close'` and `'error'` plus
@@ -1399,10 +1396,13 @@ option must be set for this event to be emitted.
 
 <!-- YAML
 added: v8.4.0
+deprecated: REPLACEME
 -->
 
 * Type: {boolean}
 
+> Stability: 0 - Deprecated
+
 `true` if the `Http2Stream` was closed while the writable side was
 still open. When set, the `'aborted'` event was emitted.
 
@@ -4220,8 +4220,11 @@ data.
 
 <!-- YAML
 added: v8.4.0
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated
+
 The `'aborted'` event is emitted whenever a `Http2ServerRequest` instance
 is closed while the underlying writable side is still open.
 
@@ -4238,10 +4241,13 @@ Just like `'end'`, this event occurs only once per response.
 
 <!-- YAML
 added: v10.1.0
+deprecated: REPLACEME
 -->
 
 * Type: {boolean}
 
+> Stability: 0 - Deprecated
+
 The `request.aborted` property will be `true` if the request has
 been aborted.
 
diff --git a/test/doctool/test-doc-api-json.mjs b/test/doctool/test-doc-api-json.mjs
index 2f085ad9b439..ff063e018d0e 100644
--- a/test/doctool/test-doc-api-json.mjs
+++ b/test/doctool/test-doc-api-json.mjs
@@ -158,5 +158,5 @@ for await (const dirent of await fs.opendir(new URL('../../out/doc/api/', import
   assert.partialDeepStrictEqual(allExpectedKeys, findAllKeys(json));
 }
 
-assert.strictEqual(numberOfDeprecatedSections, 45); // Increase this number every time a new API is deprecated.
+assert.strictEqual(numberOfDeprecatedSections, 49); // Increase this number every time a new API is deprecated.
 assert.strictEqual(numberOfRemovedAPIs, 46); // Increase this number every time a section is marked as removed.