From 98768f3b5b9db2cb384e67acd96713a6ac931df7 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Fri, 18 Sep 2020 02:48:37 -0700 Subject: [PATCH] doc: edit subpath export patterns introduction * Use parallel construction in the two sentences * Backticks around _package.json_ to match rest of file * Add comma for readability * Own the recommendation ("we recommend") PR-URL: https://github.com/nodejs/node/pull/35254 Reviewed-By: Jan Krems Reviewed-By: Michael Dawson Reviewed-By: Guy Bedford --- doc/api/packages.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/api/packages.md b/doc/api/packages.md index 8cf2397279c7eb..997ffae76a529b 100644 --- a/doc/api/packages.md +++ b/doc/api/packages.md @@ -258,9 +258,9 @@ import submodule from 'es-module-package/private-module.js'; > Stability: 1 - Experimental -Explicitly listing each exports subpath entry is recommended for packages with -a small number of exports. But for packages that have very large numbers of -subpaths this can start to cause package.json bloat and maintenance issues. +For packages with a small number of exports, we recommend explicitly listing +each exports subpath entry. But for packages that have large numbers of +subpaths, this might cause `package.json` bloat and maintenance issues. For these use cases, subpath export patterns can be used instead: