diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 0868f0fae4c..799462bf776 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -4541,6 +4541,17 @@ const server = http2.createSecureServer({
 });
 ```
 
+```mjs
+import { createSecureServer } from 'node:http2';
+
+// Deprecated
+const server = createSecureServer({
+  allowHTTP1: true,
+  Http1IncomingMessage: MyIncomingMessage,
+  Http1ServerResponse: MyServerResponse,
+});
+```
+
 ```cjs
 // Use this instead
 const server = http2.createSecureServer({
@@ -4552,6 +4563,19 @@ const server = http2.createSecureServer({
 });
 ```
 
+```mjs
+import { createSecureServer } from 'node:http2';
+
+// Use this instead
+const server = createSecureServer({
+  allowHTTP1: true,
+  http1Options: {
+    IncomingMessage: MyIncomingMessage,
+    ServerResponse: MyServerResponse,
+  },
+});
+```
+
 ### DEP0203: Passing `CryptoKey` to `node:crypto` APIs
 
 <!-- YAML
@@ -4671,6 +4695,15 @@ server.on('stream', (stream) => {
 });
 ```
 
+```mjs
+// Deprecated
+server.on('stream', (stream) => {
+  stream.on('aborted', () => {
+    // Stream was closed while the writable was still open.
+  });
+});
+```
+
 ```cjs
 // Use this instead
 server.on('stream', (stream) => {
@@ -4690,6 +4723,25 @@ server.on('stream', (stream) => {
 });
 ```
 
+```mjs
+// Use this instead
+server.on('stream', (stream) => {
+  // Read-side abort: peer cancelled before sending END_STREAM.
+  stream.on('error', (err) => {
+    if (err.code === 'ERR_HTTP2_STREAM_ABORTED' ||
+        err.code === 'ERR_HTTP2_STREAM_ERROR') {
+      // Peer cancelled the request mid-stream.
+    }
+  });
+  // Write-side abort: our response didn't fully send before close.
+  stream.on('close', () => {
+    if (!stream.writableFinished) {
+      // Writes were aborted (peer cancel, local destroy, etc.).
+    }
+  });
+});
+```
+
 The same patterns apply to the compatibility API (`req` / `res` on
 `http2.createServer((req, res) => …)`). On the read-side, errors on the
 underlying stream are emitted from `req`. On the write-side you can use