From 238885288d0a9c28b14dffd8471bb6135070267b Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Sun, 11 Oct 2020 05:35:30 -0700 Subject: [PATCH] doc: clarify experimental API elements in vm.md Remove redundant "should not be considered stable" (it immediately follows a clause saying that it is "experimental") and replace with a more clear (to me, at least) statement that we don't recommend using the feature in production. PR-URL: https://github.com/nodejs/node/pull/35594 Reviewed-By: James M Snell --- doc/api/vm.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/api/vm.md b/doc/api/vm.md index 861cac61b5fe8b..78ef3a032c4996 100644 --- a/doc/api/vm.md +++ b/doc/api/vm.md @@ -87,8 +87,8 @@ changes: * `importModuleDynamically` {Function} Called during evaluation of this module when `import()` is called. If this option is not specified, calls to `import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][]. - This option is part of the experimental modules API, and should not be - considered stable. + This option is part of the experimental modules API. We do not recommend + using it in a production environment. * `specifier` {string} specifier passed to `import()` * `script` {vm.Script} * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is @@ -979,8 +979,8 @@ changes: * `importModuleDynamically` {Function} Called during evaluation of this module when `import()` is called. If this option is not specified, calls to `import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][]. - This option is part of the experimental modules API, and should not be - considered stable. + This option is part of the experimental modules API. We do not recommend + using it in a production environment. * `specifier` {string} specifier passed to `import()` * `script` {vm.Script} * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is @@ -1077,8 +1077,8 @@ changes: * `importModuleDynamically` {Function} Called during evaluation of this module when `import()` is called. If this option is not specified, calls to `import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][]. - This option is part of the experimental modules API, and should not be - considered stable. + This option is part of the experimental modules API. We do not recommend + using it in a production environment. * `specifier` {string} specifier passed to `import()` * `script` {vm.Script} * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is @@ -1156,8 +1156,8 @@ changes: * `importModuleDynamically` {Function} Called during evaluation of this module when `import()` is called. If this option is not specified, calls to `import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][]. - This option is part of the experimental modules API, and should not be - considered stable. + This option is part of the experimental modules API. We do not recommend + using it in a production environment. * `specifier` {string} specifier passed to `import()` * `script` {vm.Script} * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is