diff --git a/doc/api/errors.md b/doc/api/errors.md index a695b43cdaa48b..e250f384ca3766 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -2496,12 +2496,12 @@ object. > Stability: 1 - Experimental When trying to `require()` a [ES Module][] under `--experimental-require-module`, -a CommonJS -> ESM or ESM -> CommonJS edge participates in an immediate cycle. +a CommonJS to ESM or ESM to CommonJS edge participates in an immediate cycle. This is not allowed because ES Modules cannot be evaluated while they are already being evaluated. To avoid the cycle, the `require()` call should not happen at the -top-level of either a ES Module (via `createRequire()`) or a ommonJS module, and +top-level of either a ES Module (via `createRequire()`) or a CommonJS module, and should be done lazily in an inner function.