From ce03a182cf4c5fb433edce2ef7dd9f21c26e76bb 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 caf300e9fd7e2c..15914d00d4a491 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 @@ -981,8 +981,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 @@ -1079,8 +1079,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 @@ -1158,8 +1158,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