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: nodejs#35254 Reviewed-By: Jan Krems <[email protected]> Reviewed-By: Michael Dawson <[email protected]> Reviewed-By: Guy Bedford <[email protected]>
aduh95 · Oct 23, 2020 · 55d15e6 · 55d15e6
1 parent 7b76e75
commit 55d15e6
Showing 1 changed file with 3 additions and 3 deletions.
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: