Skip to content

Commit

Permalink
doc: edit subpath export patterns introduction
Browse files Browse the repository at this point in the history
* 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")

Backport-PR-URL: #35757
PR-URL: #35254
Reviewed-By: Jan Krems <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
Reviewed-By: Guy Bedford <[email protected]>
  • Loading branch information
Trott authored and MylesBorins committed Nov 16, 2020
1 parent 41af927 commit 5f0b157
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions doc/api/packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down

0 comments on commit 5f0b157

Please sign in to comment.