Further doc updates

Author: lostintangent

README.md

@@ -4,18 +4,18 @@ This plugin provides client-side integration for the [CodePush service](https://
 
 ## How does it work?
 
-A React Native app is composed of a `.jsbundle` file which is generated by the packager and then distributed as part of your app's binary (the `.ipa` or `.apk` file). Traditionally, in order to update any of the JavaScript code, you'd need to recompile and re-distribute the binary, which includes any review time for the respective store(s) you are publishing to.
+A React Native app is composed of a `.jsbundle` file which is generated by the packager and distributed as part of your app's binary (the `.ipa` or `.apk` file). Traditionally, in order to update any of the JavaScript code, you'd need to recompile and re-distribute the binary, which includes any review time associated with the respective store(s) you are publishing to.
 
-The CodePush plugin for React Native helps simplify and speed up the process of getting JavaScript changes to your end-users by synchronizing the `.jsbundle` file with updates you release to the CodePush server. This way, you get the benefit of an offline, mobile experience, as well as "web-like" agility of side-loading updates as soon as they are made available. 
+The CodePush plugin for React Native helps simplify and speed up the process of getting JavaScript changes to your end-users by keeping the `.jsbundle` file synchronized with updates that are released to the CodePush server. This way, your app gets the benefits of an offline mobile experience, as well as the "web-like" agility of side-loading updates as soon as they are available. 
 
 ## Supported React Native platforms
 
 - iOS
 - Coming soon: Android (Try it out on [this branch](https://github.com/Microsoft/react-native-code-push/tree/first-check-in-for-android))
 
-## Plugin Acquisition
+## Getting Started
 
-To get started, you first need to acquire the React Native CodePush plugin by running the following command within your app's root directory:
+To get started, you first need to acquire the React Native CodePush plugin by running the following command from within your app's root directory:
 
 ```
 npm install --save react-native-code-push
@@ -42,7 +42,7 @@ Add a new value, `$(SRCROOT)/../node_modules/react-native-code-push` and select
 
 ## Plugin Configuration
 
-Once your Xcode project has been setup to build/link the CodePush plugin, you need to configure your app to consult CodePush for the location of your JS bundle, since it will "take control" of managing the current and all future versions. To do this, perform the following steps:
+Once your Xcode project has been setup to build/link the CodePush plugin, you need to configure your app to consult CodePush for the location of your JS bundle, since it is responsible for synchronizing it with updates that are released to the CodePush server. To do this, perform the following steps:
 
 1. Open up the `AppDelegate.m` file, and add an import statement for the CodePush headers:
 
@@ -92,14 +92,14 @@ The simplest way to do this is to perform the following in your app's root compo
     CodePush.sync();
     ```
 
-If an update is available, it will be silently downloaded, and installed the next time the app is restarted (either explicitly by the end-user or by the OS). This experience ensures the least invasive experience for your end-users. If you would like to display a confirmation dialog (an "active install"), or customize the update experience in any way, refer to the `sync` method's [API reference](#codepushsync) for information on how to tweak this default behavior.
+If an update is available, it will be silently downloaded, and installed the next time the app is restarted (either explicitly by the end-user or by the OS), which ensures the least invasive experience for your end-users. If you would like to display a confirmation dialog (an "active install"), or customize the update experience in any way, refer to the `sync` method's [API reference](#codepushsync) for information on how to tweak this default behavior.
 
 ## Releasing code updates
 
 Once your app has been configured and distributed to your users, and you've made some JS changes, it's time to release it to them instantly! To do this, run the following steps:
 
 1. Execute `react-native bundle` in order to generate the JS bundle for your app.
-2. Execute `code-push release <appName> ./ios/main.jsbundle <appVersion>` in order to publish the generated JS bundle to the server (assuming your CWD is the root directory of your React Native app).
+2. Execute `code-push release <appName> ./ios/main.jsbundle <appVersion> --deploymentName <deploymentName>` in order to publish the generated JS bundle to the server (assuming your CWD is the root directory of your React Native app). 
 
 And that's it! For more information regarding the CodePush API, including the various options you can pass to the `sync` method, refer to the reference section below.