diff --git a/doc/api/assert.md b/doc/api/assert.md
index 7ee446ce98b876..e908b70cee4df7 100644
--- a/doc/api/assert.md
+++ b/doc/api/assert.md
@@ -444,9 +444,9 @@ added: v18.8.0
 
 * `fn` {Function} a tracked function to reset.
 
-reset calls of the call tracker.
-if a tracked function is passed as an argument, the calls will be reset for it.
-if no arguments are passed, all tracked functions will be reset
+Reset calls of the call tracker.
+If a tracked function is passed as an argument, the calls will be reset for it.
+If no arguments are passed, all tracked functions will be reset
 
 ```mjs
 import assert from 'node:assert';
diff --git a/doc/api/stream.md b/doc/api/stream.md
index 434f5bea0e22ed..9b32801305f078 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -3330,7 +3330,7 @@ reader.read().then(({ value, done }) => {
 added: REPLACEME
 -->
 
-* {boolean} objectMode
+* `objectMode` {boolean}
 * Returns: {integer}
 
 Returns the default highWaterMark used by streams.
@@ -3342,8 +3342,8 @@ Defaults to `16384` (16 KiB), or `16` for `objectMode`.
 added: REPLACEME
 -->
 
-* {boolean} objectMode
-* {integer} highWaterMark value
+* `objectMode` {boolean}
+* `value` {integer} highWaterMark value
 
 Sets the default highWaterMark used by streams.