doc: edit subpath export patterns introduction

Trott · aduh95 · commit 55d15e64ad2f · 2020-10-23T20:27:11.000+02:00
* 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: nodejs#35254 Reviewed-By: Jan Krems <jan.krems@gmail.com> Reviewed-By: Michael Dawson <midawson@redhat.com> Reviewed-By: Guy Bedford <guybedford@gmail.com>
diff --git 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:
 
