From fe23ce2f5212d3c52f5a704d13a71e97a120e233 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

---
 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 2b42e9a5dbd689..16211cb0a3d49f 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