From c39467cb4782e559c106d3d527bb0bd87439bbaa Mon Sep 17 00:00:00 2001
From: dfabulich <dan@fabulich.com>
Date: Tue, 19 May 2020 16:01:30 -0700
Subject: [PATCH] doc: mention --experimental-top-level-await flag

PR-URL: https://github.com/nodejs/node/pull/33473
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/cli.md                  | 10 ++++++++++
 doc/changelogs/CHANGELOG_V14.md |  3 ++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 2015a45608f9b4..1a6a8d361918f2 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -226,6 +226,16 @@ the ability to import a directory that has an index file.
 
 Please see [customizing ESM specifier resolution][] for example usage.
 
+### `--experimental-top-level-await`
+<!-- YAML
+added: v14.3.0
+-->
+
+Enable experimental top-level `await` keyword support, available only in ES
+module scripts.
+
+(See also `--experimental-repl-await`.)
+
 ### `--experimental-vm-modules`
 <!-- YAML
 added: v9.6.0
diff --git a/doc/changelogs/CHANGELOG_V14.md b/doc/changelogs/CHANGELOG_V14.md
index a8fea39aeec99a..4fb67303277d60 100644
--- a/doc/changelogs/CHANGELOG_V14.md
+++ b/doc/changelogs/CHANGELOG_V14.md
@@ -51,7 +51,8 @@ including the autocompleted part. Pressing `<escape>` cancels that behavior.
 
 #### Support for Top-Level Await
 
-It's now possible to use the await keyword outside of async functions.
+It's now possible to use the await keyword outside of async functions, with the
+`--experimental-top-level-await` flag.
 
 #### Other Notable Changes