(cleanup/ fix grammer & typos) packager/README.md

-fix a few typos
-edit grammar on a few sentences, adding punctuation or keeping tense consistent
-make capitalization consistent in ReactPackager.middleware(options) section
This commit is contained in:
David Rabkin 2015-03-29 11:21:27 -07:00
parent 3ec02183ae
commit e76f175acb
1 changed files with 14 additions and 14 deletions

View File

@ -2,12 +2,12 @@ React Native Packager
-------------------- --------------------
React Native Packager is a project similar in scope to browserify or React Native Packager is a project similar in scope to browserify or
webpack, it provides a CommonJS-like module system, JavaScript webpack; it provides a CommonJS-like module system, JavaScript
compilation (ES6, Flow, JSX), bundling, and asset loading. compilation (ES6, Flow, JSX), bundling, and asset loading.
The main difference is the Packager's focus on compilation and The main difference is the Packager's focus on compilation and
bundling speed. We aim for a sub-second edit-reload bundling speed. We aim for a sub-second edit-reload
cycles. Additionally, we don't want users -- with large code bases -- cycle. Additionally, we don't want users -- with large code bases --
to wait more than a few seconds after starting the packager. to wait more than a few seconds after starting the packager.
The main deviation from the node module system is the support for our The main deviation from the node module system is the support for our
@ -19,7 +19,7 @@ namely the node module format. We want to even go further, and let you
choose your own packager and asset pipeline or even integrate into choose your own packager and asset pipeline or even integrate into
your existing infrastructure. your existing infrastructure.
React Native users need not to understand how the packager work, React Native users need not to understand how the packager works;
however, this documentation might be useful for advanced users and however, this documentation might be useful for advanced users and
people who want to fix bugs or add features to the packager (patches people who want to fix bugs or add features to the packager (patches
welcome!). welcome!).
@ -45,10 +45,10 @@ Does the following in order:
### /path/to/moduleName.map ### /path/to/moduleName.map
* if the package has been previously generated via the `.bundle` * if the package has been previously generated via the `.bundle`
endpoint then the source map will be generated from that package endpoint, then the source map will be generated from that package
* if the package has not been previously asked for, this will go * if the package has not been previously asked for, this will go
through the same steps outlined in the `.bundle` endpoint then through the same steps outlined in the `.bundle` endpoint, then
generate the source map. generate the source map
Note that source map generation currently assumes that the code has Note that source map generation currently assumes that the code has
been compiled with jstransform, which preserves line and column been compiled with jstransform, which preserves line and column
@ -66,15 +66,15 @@ Here are the current options the packager accepts:
* `minify` boolean, defaults to false: whether to minify the bundle. * `minify` boolean, defaults to false: whether to minify the bundle.
* `runModule` boolean, defaults to true: whether to require your entry * `runModule` boolean, defaults to true: whether to require your entry
point module. So if you requested `moduleName`, this option will add point module. So if you requested `moduleName`, this option will add
a `require('moduleName')` the end of your bundle. a `require('moduleName')` to the end of your bundle.
* `inlineSourceMap` boolean, defaults to false: whether to inline * `inlineSourceMap` boolean, defaults to false: whether to inline
source maps. source maps.
### /debug ### /debug
This is a page used for debugging, it has links to two pages: This is a page used for debugging; it has links to two pages:
* Cached Packages: which shows you the packages that's been already * Cached Packages: which shows you the packages that have already been
generated and cached generated and cached
* Dependency Graph: is the in-memory graph of all the modules and * Dependency Graph: is the in-memory graph of all the modules and
their dependencies their dependencies
@ -103,8 +103,8 @@ middleware. Takes the following options:
packager packager
* `polyfillModuleName` array: Paths to polyfills you want to be * `polyfillModuleName` array: Paths to polyfills you want to be
included at the start of the bundle included at the start of the bundle
* `cacheVersion` string: used in creating the cache file * `cacheVersion` string: Used in creating the cache file
* `resetCache` boolean, defaults to false: whether to use the cache on * `resetCache` boolean, defaults to false: Whether to use the cache on
disk disk
* `transformModulePath` string: Path to the module used as a * `transformModulePath` string: Path to the module used as a
JavaScript transformer JavaScript transformer
@ -133,6 +133,6 @@ is informed by React Native needs.
### Why didn't you use webpack? ### Why didn't you use webpack?
We love webpack, however, when we tried on our codebase it was slower We love webpack; however, when we tried it on our codebase, it was slower
than our developers would like it to be. You find can more discussion about than our developers wanted it to be. You find can more discussion about
the subject [here](https://github.com/facebook/react-native/issues/5) the subject [here](https://github.com/facebook/react-native/issues/5).