Update copy and add note regarding embedded bundling

kgryte · kgryte · commit 2e3d74f3e674 · 2018-12-28T16:22:00.000-08:00
diff --git a/README.md b/README.md
@@ -176,7 +176,7 @@ which will expose the `stdlib` command. For example, to see available sub-comman
 $ stdlib help
 ```
 
-For distributable bundles for use in browser environments, see the [`dist`][stdlib-bundles] directory and associated [guide][stdlib-bundles].
+For distributable bundles for use in browser environments or as shared ("vendored") libraries in server environments, see the [`dist`][stdlib-bundles] directory and associated [guide][stdlib-bundles].
 
 Otherwise, to install as a system library, follow the [download][stdlib-development], [configuration][stdlib-development], and [installation][stdlib-development] instructions as described in the [development guide][stdlib-development].
 
diff --git a/dist/README.md b/dist/README.md
@@ -26,7 +26,7 @@ limitations under the License.
 
 <section class="intro">
 
-This directory contains distributable files for use in browser environments. Each distributable is a standalone [UMD][umd] bundle which, if no recognized module system is present, will expose bundle contents to the global scope.
+This directory contains distributable files for use in browser environments or as shared ("vendored") libraries in server environments. Each distributable is a standalone [UMD][umd] bundle which, if no recognized module system is present, will expose bundle contents to the global scope.
 
 </section>
 
@@ -80,6 +80,8 @@ If no recognized module system is present, access bundle contents via the global
 
     Please be mindful that [unpkg][unpkg] is a free, best-effort service relying on donated infrastructure which does **not** provide **any** availability guarantees. Under **no** circumstances should you **abuse** or **misuse** the service. You have been **warned**.
 
+-   If you intend on embedding a standalone bundle **within** another bundle, you may need to rename `require` calls within the standalone bundle **before** bundling in order to maintain scoped module resolution. For example, if you plan on using [browserify][browserify] to generate a bundle containing embedded bundles, [browserify][browserify] plugins exist to "de-require" those bundles prior to bundling.
+
 ### Bundles
 
 #### Main
@@ -363,6 +365,8 @@ The help bundle, `stdlib-flat-help`, contains help texts for packages exposed in
 
 [unpkg]: https://unpkg.com/#/
 
+[browserify]: https://github.com/browserify/browserify
+
 [@stdlib/namespace]: https://github.com/stdlib-js/stdlib
 
 [@stdlib/repl]: https://github.com/stdlib-js/stdlib
