[pull] main from nodejs:main

.eslintignore

@@ -2,3 +2,5 @@
 static/legacy/
 external/
 build/
+# Top level await isn't supported till ESLint 8
+locale/en/blog/release/v17.0.0.md

.eslintrc

@@ -9,5 +9,38 @@
   ],
   "rules": {
     "prettier/prettier": "error"
-  }
+  },
+  "overrides": [
+    {
+      "files": [
+        "**/*.md"
+      ],
+      "plugins": [
+        "markdown"
+      ],
+      "processor": "markdown/markdown"
+    },
+    {
+      "files": [
+        "**/*.md/*.js"
+      ],
+      "rules": {
+        "eqeqeq": "off",
+        "no-const-assign": "off",
+        "no-undef": "off",
+        "no-unused-expressions": "off",
+        "no-unused-vars": "off",
+        "node/handle-callback-err": "off",
+        "node/no-deprecated-api": "off",
+        "prefer-const": "off",
+        "prettier/prettier": [
+          "error",
+          {
+            "singleQuote": true,
+            "trailingComma": "none"
+          }
+        ]
+      }
+    }
+  ]
 }

.stylelintrc

@@ -1,6 +1,6 @@
 {
   "extends": [
-    "stylelint-config-twbs-bootstrap/scss"
+    "stylelint-config-twbs-bootstrap"
   ],
   "rules": {
     "declaration-no-important": null,

build.js

@@ -17,7 +17,7 @@ const feed = require('metalsmith-feed');
 const discoverHelpers = require('metalsmith-discover-helpers');
 const discoverPartials = require('metalsmith-discover-partials');
 const layouts = require('metalsmith-layouts');
-const markdown = require('metalsmith-markdown');
+const markdown = require('@metalsmith/markdown');
 const prism = require('metalsmith-prism');
 const permalinks = require('@metalsmith/permalinks');
 const pagination = require('metalsmith-yearly-pagination');

layouts/css/page-modules/_home.scss

@@ -129,19 +129,19 @@
  */
 
 [role="button"] {
-  border: 1px solid hsl(0, 0%, 39%);
+  border: 1px solid hsl(0deg, 0%, 39%);
   border-radius: 5px;
-  box-shadow: 0 1px 2px hsl(0, 0%, 45%);
+  box-shadow: 0 1px 2px hsl(0deg, 0%, 45%);
   color: #fff;
-  text-shadow: 0 -1px 1px hsl(0, 0%, 15%);
-  background-color: hsl(0, 0%, 31%);
-  background-image: linear-gradient(to bottom, hsl(0, 0%, 33%), hsl(0, 0%, 27%));
+  text-shadow: 0 -1px 1px hsl(0deg, 0%, 15%);
+  background-color: hsl(0deg, 0%, 31%);
+  background-image: linear-gradient(to bottom, hsl(0deg, 0%, 33%), hsl(0deg, 0%, 27%));
 }
 
 [role="button"]:hover {
-  border-color: hsl(0, 0%, 19%);
-  background-color: hsl(0, 0%, 21%);
-  background-image: linear-gradient(to bottom, hsl(0, 0%, 23%), hsl(0, 0%, 17%));
+  border-color: hsl(0deg, 0%, 19%);
+  background-color: hsl(0deg, 0%, 21%);
+  background-image: linear-gradient(to bottom, hsl(0deg, 0%, 23%), hsl(0deg, 0%, 17%));
   cursor: pointer;
 }
 
@@ -158,34 +158,34 @@
   right: calc(-1px - 3px - 3px);
   bottom: calc(-1px - 3px - 3px);
   left: calc(-1px - 3px - 3px);
-  border: 3px solid hsl(0, 0%, 39%);
+  border: 3px solid hsl(0deg, 0%, 39%);
 
   /* button border radius + outline width + offset */
   border-radius: calc(5px + 3px + 3px);
   content: "";
 }
 
 [role="button"]:active {
-  border-color: hsl(0, 0%, 29%);
-  background-color: hsl(0, 0%, 11%);
-  background-image: linear-gradient(to bottom, hsl(0, 0%, 33%), hsl(0, 0%, 27%));
-  box-shadow: inset 0 3px 5px 1px hsl(0, 0%, 10%);
+  border-color: hsl(0deg, 0%, 29%);
+  background-color: hsl(0deg, 0%, 11%);
+  background-image: linear-gradient(to bottom, hsl(0deg, 0%, 33%), hsl(0deg, 0%, 27%));
+  box-shadow: inset 0 3px 5px 1px hsl(0deg, 0%, 10%);
 }
 
 [role="button"][aria-pressed] {
-  border-color: hsl(0, 0%, 29%);
-  box-shadow: 0 1px 2px hsl(0, 0%, 35%);
-  text-shadow: 0 -1px 1px hsl(0, 0%, 5%);
-  background-color: hsl(0, 0%, 31%);
-  background-image: linear-gradient(to bottom, hsl(0, 0%, 33%), hsl(0, 0%, 27%));
+  border-color: hsl(0deg, 0%, 29%);
+  box-shadow: 0 1px 2px hsl(0deg, 0%, 35%);
+  text-shadow: 0 -1px 1px hsl(0deg, 0%, 5%);
+  background-color: hsl(0deg, 0%, 31%);
+  background-image: linear-gradient(to bottom, hsl(0deg, 0%, 33%), hsl(0deg, 0%, 27%));
 }
 
 [role="button"][aria-pressed]:hover {
-  border-color: hsl(0, 0%, 9%);
-  background-color: hsl(0, 0%, 31%);
-  background-image: linear-gradient(to bottom, hsl(0, 0%, 13%), hsl(0, 0%, 7%));
+  border-color: hsl(0deg, 0%, 9%);
+  background-color: hsl(0deg, 0%, 31%);
+  background-image: linear-gradient(to bottom, hsl(0deg, 0%, 13%), hsl(0deg, 0%, 7%));
 }
 
 [role="button"][aria-pressed]:focus::before {
-  border-color: hsl(0, 0%, 29%);
+  border-color: hsl(0deg, 0%, 29%);
 }

layouts/css/page-modules/_scrollToTop.scss

@@ -22,9 +22,9 @@ html {
 
   // Prevent button from flashing on page load
   opacity: 0;
-  animation: buttonFade .5s 1s 1 forwards;
+  animation: button-fade .5s 1s 1 forwards;
 
-  @keyframes buttonFade {
+  @keyframes button-fade {
     0% {
       opacity: 0;
     }

locale/en/blog/release/v12.16.0.md

@@ -130,7 +130,6 @@ The new `EventEmitter.on` static method allows to async iterate over events:
 const { on, EventEmitter } = require('events');
 
 (async () => {
-
   const ee = new EventEmitter();
 
   // Emit later on
@@ -145,7 +144,6 @@ const { on, EventEmitter } = require('events');
     // if concurrent execution is required.
     console.log(event); // prints ['bar'] [42]
   }
-
 })();
 ```
 

locale/en/blog/release/v12.17.0.md

@@ -62,16 +62,18 @@ function logWithId(msg) {
 }
 
 let idSeq = 0;
-http.createServer((req, res) => {
-  asyncLocalStorage.run(idSeq++, () => {
-    logWithId('start');
-    // Imagine any chain of async operations here.
-    setImmediate(() => {
-      logWithId('finish');
-      res.end();
+http
+  .createServer((req, res) => {
+    asyncLocalStorage.run(idSeq++, () => {
+      logWithId('start');
+      // Imagine any chain of async operations here.
+      setImmediate(() => {
+        logWithId('finish');
+        res.end();
+      });
     });
-  });
-}).listen(8080);
+  })
+  .listen(8080);
 ```
 
 In this example, the `logWithId` function will always know what the current

locale/en/blog/release/v14.17.0.md

@@ -27,7 +27,7 @@ MySQL.prototype.query = function query(queryString, values, callback) {
   // Broadcast query information whenever a query is made
   channel.publish({
     query: queryString,
-    host: this.hostname,
+    host: this.hostname
   });
 
   this.doQuery(queryString, values, callback);

locale/en/blog/release/v15.1.0.md

@@ -24,7 +24,7 @@ MySQL.prototype.query = function query(queryString, values, callback) {
   // Broadcast query information whenever a query is made
   channel.publish({
     query: queryString,
-    host: this.hostname,
+    host: this.hostname
   });
 
   this.doQuery(queryString, values, callback);

locale/en/blog/release/v8.0.0.md

@@ -153,8 +153,12 @@ const util = require('util');
 const readfile = util.promisify(fs.readFile);
 
 readfile('/some/file')
-  .then((data) => { /** ... **/ })
-  .catch((err) => { /** ... **/ });
+  .then((data) => {
+    /** ... **/
+  })
+  .catch((err) => {
+    /** ... **/
+  });
 ```
 
 ### Console changes
@@ -183,7 +187,7 @@ Codes are manifest to the user in two ways:
 For instance, calling `assert(false)` will generate the following
 `AssertionError`:
 
-```js
+```shell
 > assert(false)
 AssertionError [ERR_ASSERTION]: false == true
     at repl:1:1
@@ -240,7 +244,9 @@ const session = new inspector.Session();
 session.connect();
 
 // Listen for inspector events
-session.on('inspectorNotification', (message) => { /** ... **/ });
+session.on('inspectorNotification', (message) => {
+  /** ... **/
+});
 
 // Send messages to the inspector
 session.post(message);

locale/en/docs/guides/buffer-constructor-deprecation.md

@@ -186,7 +186,7 @@ compiles to.
 For Node.js 0.10.x (and below) support:
 
 ```js
-var buf;
+let buf;
 if (Buffer.alloc) {
   buf = Buffer.alloc(number);
 } else {