From 985b96a7d557e80e182acd95b3482b30c214a61b Mon Sep 17 00:00:00 2001
From: Antoine du Hamel <duhamelantoine1995@gmail.com>
Date: Mon, 28 Sep 2020 13:23:53 +0200
Subject: [PATCH] doc,esm: add history support info

Documents which versions of Node.js support which ESM-feature.

Backport-PR-URL: https://github.com/nodejs/node/pull/35757
PR-URL: https://github.com/nodejs/node/pull/35395
Reviewed-By: Geoffrey Booth <webmaster@geoffreybooth.com>
Reviewed-By: Guy Bedford <guybedford@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/esm.md      | 17 +++++++++++++++++
 doc/api/packages.md | 27 +++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/doc/api/esm.md b/doc/api/esm.md
index 4b5679b3c3363d..feca5527937a88 100644
--- a/doc/api/esm.md
+++ b/doc/api/esm.md
@@ -2,6 +2,23 @@
 
 <!--introduced_in=v8.5.0-->
 <!-- type=misc -->
+<!-- YAML
+added: v8.5.0
+changes:
+  - version:
+    - REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/35249
+    description: Support for detection of CommonJS named exports.
+  - version:
+    - v12.17.0
+    pr-url: https://github.com/nodejs/node/pull/29866
+    description: Loading ECMAScript modules no longer requires a command-line flag.
+  - version: v12.0.0
+    pr-url: https://github.com/nodejs/node/pull/26745
+    description:
+      Add support for ES modules using `.js` file extension via `package.json`
+      `"type"` field.
+-->
 
 > Stability: 1 - Experimental
 
diff --git a/doc/api/packages.md b/doc/api/packages.md
index 4da77aedefea19..df7383d2532abf 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -1,6 +1,33 @@
 # Modules: Packages
 
 <!-- type=misc -->
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/34718
+    description: Add support for `"exports"` patterns.
+  - version: v12.19.0
+    pr-url: https://github.com/nodejs/node/pull/34117
+    description: Add package `"imports"` field.
+  - version:
+    - v12.16.0
+    pr-url: https://github.com/nodejs/node/pull/31001
+    description: Unflag conditional exports.
+  - version:
+    - v12.16.0
+    pr-url: https://github.com/nodejs/node/pull/31002
+    description: Unflag self-referencing a package using its name.
+  - version: v12.7.0
+    pr-url: https://github.com/nodejs/node/pull/28568
+    description:
+      Introduce `"exports"` `package.json` field as a more powerful alternative
+      to the classic `"main"` field.
+  - version: v12.0.0
+    pr-url: https://github.com/nodejs/node/pull/26745
+    description:
+      Add support for ES modules using `.js` file extension via `package.json`
+      `"type"` field.
+-->
 
 ## Introduction