tools: lint js in doc/**/*.md

doc/api/esm.md

@@ -508,7 +508,7 @@ module default import or its corresponding sugar syntax:
 
 ```js
 import { default as cjs } from 'cjs';
-// identical to the above
+// Identical to the above
 import cjsSugar from 'cjs';
 
 console.log(cjs);

doc/api/modules.md

@@ -890,7 +890,7 @@ built-in modules and if a name matching a built-in module is added to the cache,
 only `node:`-prefixed require calls are going to receive the built-in module.
 Use with care!
 
-<!-- eslint-disable node-core/no-duplicate-requires -->
+<!-- eslint-disable node-core/no-duplicate-requires, no-restricted-syntax -->
 
 ```js
 const assert = require('node:assert');

doc/api/perf_hooks.md

@@ -28,7 +28,7 @@ performance.measure('Start to Now');
 
 performance.mark('A');
 (async function doSomeLongRunningProcess() {
- await new Promise(r => setTimeout(r, 5000));
+ await new Promise((r) => setTimeout(r, 5000));
  performance.measure('A to Now', 'A');
 
  performance.mark('B');

doc/api/process.md

@@ -2111,10 +2111,10 @@ class Test {
  constructor() {
  finalization.register(this, (ref) => ref.dispose());
 
- // even something like this is highly discouraged
+ // Even something like this is highly discouraged
  // finalization.register(this, () => this.dispose());
-  }
-  dispose() {}
+ }
+ dispose() {}
 }
 ```
 

doc/api/stream.md

@@ -315,7 +315,7 @@ events (due to incorrect stream implementations) do not cause unexpected
 crashes. If this is unwanted behavior then `options.cleanup` should be set to
 `true`:
 
-```js
+```mjs
 await finished(rs, { cleanup: true });
 ```
 
@@ -3926,7 +3926,7 @@ const { StringDecoder } = require('node:string_decoder');
 class StringWritable extends Writable {
  constructor(options) {
  super(options);
- this._decoder = new StringDecoder(options && options.defaultEncoding);
+ this._decoder = new StringDecoder(options?.defaultEncoding);
  this.data = '';
  }
  _write(chunk, encoding, callback) {

doc/api/test.md

@@ -3284,7 +3284,7 @@ test('snapshot test with default serialization', (t) => {
 
 test('snapshot test with custom serialization', (t) => {
  t.assert.snapshot({ value3: 3, value4: 4 }, {
- serializers: [(value) => JSON.stringify(value)]
+ serializers: [(value) => JSON.stringify(value)],
  });
 });
 ```

doc/api/util.md

@@ -513,7 +513,7 @@ The mapping between error codes and string messages is platform-dependent.
 ```js
 fs.access('file/that/does/not/exist', (err) => {
  const name = util.getSystemErrorMessage(err.errno);
- console.error(name); // no such file or directory
+ console.error(name); // No such file or directory
 });
 ```
 

eslint.config.mjs

@@ -43,10 +43,9 @@ export default [
  '**/node_modules/**',
  'benchmark/fixtures/**',
  'benchmark/tmp/**',
- 'doc/**/*.js',
  'doc/changelogs/CHANGELOG_V1*.md',
- '!doc/api_assets/*.js',
  '!doc/changelogs/CHANGELOG_V18.md',
+ 'doc/changelogs/CHANGELOG_V23.md',
  'lib/punycode.js',
  'test/.tmp.*/**',
  'test/addons/??_*',