cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
Subject [3/8] Update documentation with standard STYLESHEET guide.
Date Tue, 11 Jun 2013 00:11:14 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/ios/index.md b/docs/en/edge/guide/getting-started/ios/index.md
index f894b93..1fa7d6b 100644
--- a/docs/en/edge/guide/getting-started/ios/index.md
+++ b/docs/en/edge/guide/getting-started/ios/index.md
@@ -6,9 +6,9 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          to you under the Apache License, Version 2.0 (the
          "License"); you may not use this file except in compliance
          with the License.  You may obtain a copy of the License at
-
+         
            http://www.apache.org/licenses/LICENSE-2.0
-
+         
          Unless required by applicable law or agreed to in writing,
          software distributed under the License is distributed on an
          "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -26,68 +26,65 @@ Apache Cordova is a library used to create native mobile applications using Web
 
 ### Requirements ###
 
-
-- **Intel-based Computer with Mac® OS X® Lion or greater (10.7.4+)**

-    The Apple® tools required for building iOS applications run only on the OS X operating system. The version of the development environment required, Xcode® 4.5, runs only on Mac OS X version 10.7 (Lion) or greater.  

+- **Intel-based Computer with Mac® OS X® Lion or greater (10.7.4+)**
+    The Apple® tools required for building iOS applications run only on the OS X operating system. The version of the development environment required, Xcode® 4.5, runs only on Mac OS X version 10.7 (Lion) or greater.
 - **Xcode 4.5 and iOS 6 SDK**
-    
    To submit apps to the Apple App Store℠, you must be using the latest versions of the Apple tools. Currently the latest versions are Xcode 4.5.2 and the iOS 6 SDK (Software Development Kit). The download of Xcode 4.5.2 includes the iOS 6 SDK. 

-    - Download from the [App Store](https://itunes.apple.com/us/app/xcode/id497799835?mt=12) (https://itunes.apple.com/us/app/xcode/id497799835?mt=12). 

-    - Download from [Apple Developer Downloads](https://developer.apple.com/downloads/index.action) (https://developer.apple.com/downloads/index.action).  Note:  This link requires Apple Developer registration.
+         To submit apps to the Apple App Store℠, you must use the latest versions of the Apple tools. Currently the latest versions are Xcode 4.5.2 and the iOS 6 SDK (Software Development Kit). The download of Xcode 4.5.2 includes the iOS 6 SDK.
+    - Download from the [App Store](https://itunes.apple.com/us/app/xcode/id497799835?mt=12) (https://itunes.apple.com/us/app/xcode/id497799835?mt=12).
+    - Download from [Apple Developer Downloads](https://developer.apple.com/downloads/index.action) (https://developer.apple.com/downloads/index.action).  __NOTE:__  This link requires Apple Developer registration.
 
 - **Xcode Command Line Tools**
 
-    Cordova uses the command line to create a new application project.  To access the Xcode tools from the command line an additional download is required.  The tools are downloaded from within Xcode.

+    Cordova uses the command line to create a new application project.  To access the Xcode tools from the command line an additional download is required.  The tools are downloaded from within Xcode.
     1. Open Xcode
-    2. Select the following via the Xcode Menus:  **Xcode Preferences> Downloads>Command Line Tools**.  This will download and install copies of the core command line tools and system headers into system folders on your computer.
-
+    2. Select the following via the Xcode Menus:  **Xcode Preferences> Downloads>Command Line Tools**.  This downloads and installs copies of the core command-line tools and system headers into your computer's system folders.
 
 - **iOS Device**
 
-    You can test many of the Cordova features using the iOS simulator that is installed with the iOS SDK and Xcode, but you will need an actual device to fully test all of the device features used in your applications before submitting to the App Store.  The device must have at least iOS 5.x installed - this is the minimum iOS version supported as of Cordova 2.3.  Devices that support at least iOS 5 include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd Generation or later. 
    
    In addition, to install apps onto a device, you must be a member of the [iOS Developer Program](https://developer.apple.com/programs/ios/) from Apple.  The program costs $99 per year. This Getting Started guide documents deploying the application to the iOS simulator so registration with the developer program is not required.
+    You can test many of the Cordova features using the iOS simulator installed with the iOS SDK and Xcode, but you need an actual device to fully test all of the device features your applications use before submitting to the App Store.  The device must have at least iOS 5.x installed, the minimum iOS version supported as of Cordova 2.3.  Devices that support at least iOS 5 include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd Generation or later. To install apps onto a device, you must also be a member of Apple's [iOS Developer Program](https://developer.apple.com/programs/ios/).  The program costs $99 per year. This Getting Started guide shows how to deploy the application to the iOS simulator, in which case developer program registration is not required.
 
 ## Install Cordova
 
 ### Download Cordova
 
-Download the latest version of [Apache Cordova](http://www.apache.org/dist/cordova/) from http://www.apache.org/dist/cordova/.  Click on the Download icon and select cordova-X.Y.Z-src.zip to download to your machine. The X, Y and Z represent the version number of Cordova, for example x.x.x.  The download includes the code for all of the Apache Cordova supported platforms.  

+Download the latest version of [Apache Cordova](http://www.apache.org/dist/cordova/) from http://www.apache.org/dist/cordova/.  Click on the Download icon and select cordova-X.Y.Z-src.zip to download to your machine. The X, Y and Z represent the version number of Cordova, for example x.x.x.  The download includes the code for all of the Apache Cordova supported platforms.
 ### Extract Cordova
 
-To access the code it will need to be extracted from the archive (.zip) file.
+To access the code, it needs to be extracted from the archive (.zip) file:
 
+1. Navigate to the folder where you downloaded the code.  Find the cordova-X.Y.Z-src.zip file.
+    __NOTE:__ The filenames change with each incremental version of Cordova.
 
-1. Navigate to the folder where you downloaded the code.  Find the cordova-X.Y.Z-src.zip file.  

-    Note: The file names change with each new version of Cordova.  The file name will be different if you are using an updated or newer version of Cordova.

+2. Using the Finder® app, double-click the file to extract. This creates a directory named `cordova-X.Y.Z`.
 
-2. Using the Finder® app, double click the file to extract. This will create a directory named, cordova-X.Y.Z.  

-
-3. Expand this folder and locate the cordova-ios.zip file and double click to extract it.  

+3. Expand this folder and locate the cordova-ios.zip file and double-click to extract it.
 
 4. The code for iOS is within the cordova-ios directory structure.
 
 ## Project Creation
 
-Xcode projects for Cordova are created by invoking a script file via the command line. The following steps explain how to create the necessary directory structure, open and use the Terminal application to create a new project, and execute the create script. 

+Xcode projects for Cordova are created by invoking a script file via the command line. The following steps explain how to create the necessary directory structure, open and use the Terminal application to create a new project, and execute the create script.
 ### Determine Project Location
 
-Determine where on your system you will locate the Xcode project files for your application.  For this tutorial I created a CordovaXY directory under my Documents folder:  ~/Documents/CordovaXY  where the X and Y refer the to Cordova version #.

+Determine where on your system to place your application's Xcode
+project files.  This tutorial uses `~/Documents/CordovaXY`, where the
+'X' and 'Y' refer the to Cordova version number.
 
-1. In Finder navigate to the Documents Directory. 

+1. In the Finder, navigate to the `Documents` directory.
 
-2. Create a directory called CordovaXY within the Documents directory where the X and Y represent the Cordova version number (23, for example).  You can use a different directory name or location if you wish but you will need to remember this directory location and name for subsequent steps.

+2. Create a subdirectory within `Documents` called `CordovaXY`, where the 'X' and 'Y' represent the Cordova version number (23, for example).  You can use a different directory name or location if you wish, but you need to remember it for subsequent steps.
 
 ### Open Terminal
 
-1. In Finder, navigate to the Applications Folder. Find and expand the Utilities Folder.

-
-2. Locate the Terminal app and double click to open it. 

+1. Open the Terminal application, located by default in the `Applications/Utilities` folder.
 
-3. In Finder, navigate to the cordova-ios directory from the downloaded and extracted Cordova code and expand it if necessary.   Highlight the bin directory as shown:
+3. Use the Finder to navigate to the `cordova-ios` directory from the downloaded and extracted Cordova code. Highlight the `bin` subdirectory as shown:
 
   ![](img/guide/getting-started/ios/bin_dir_listing.png)
 
-  **Note:** This screen capture was from the Cordova-2.3.0 download, your listing will vary based on the actual Cordova version installed.
+  __NOTE:__ Your listing varies depending on Cordova's version number.
 
-4. Drag this directory to the open Terminal icon in the dock.  This will open up a default terminal window with the path set to the bin directory.
+4. Drag this directory to the open the Terminal icon in the dock.  This opens up a default terminal window with the path set to the `bin` directory.
 
 ### Create New Project
 
@@ -95,21 +92,22 @@ Determine where on your system you will locate the Xcode project files for your
 
   1. Determine Required Parameters
 
-  There are 3 ordered, required parameters for creating a Cordova project from the command line:

+  Three parameters are required to creating a Cordova project from the command line, in this order:
+
     1. **project location**
 
-      This is the directory where the Xcode project and files for the application will be located. This tutorial is using ~/Documents/CordovaXY as the base location and the application name as the project directory.  Thus the location for our project will be 
~/Documents/CordovaXY/HelloWorld, where HelloWorld is the project name  (note that the X and Y represent the Cordova version, for example 22 for version 2.2).  The final directory, HelloWorld in this example, must not already exist as it will be created during execution of the command.
+      This directory is where the Xcode project and application files are to be located. This tutorial uses `~/Documents/CordovaXY` as the base location (with 'X' and 'Y' representing the Cordova version number) and the `HelloWorld` application name as the project directory.  Since the command creates the final `HelloWorld` directory, it must not already exist.
 
     2. **package name**
 
-      When submitting apps to the App Store, this must be the reverse domain name App ID that is created via the Apple Provisioning Portal (described in the Deploy to Device section).  The Provisioning Portal is accessible once you have paid for and signed into your iOS Developer Account.   Since you will not be submitting this sample app, this tutorial uses org.apache.Cordova plus the app name, HelloWorld:  
org.apache.cordova.HelloWorld

+      When submitting apps to the App Store, this must be the reverse domain name App ID that is created via the Apple Provisioning Portal (described in the Deploy to Device section).  The Provisioning Portal is accessible once you have paid for and signed into your iOS Developer Account.   Since you don't need to submit this sample app, this tutorial uses `org.apache.Cordova` plus the `HelloWorld` app name:   `org.apache.cordova.HelloWorld`
     3. **project name**
 
-      This is the name of the actual project.  Most developers make the project name and the application name the same.  In this example the project name is HelloWorld.

+      This is the name of the actual project.  Most developers match the project name with the application name, so  in this example it's `HelloWorld`.
   2. Execute the Command
 
   In the terminal app with bin as the current directory, enter the 3 pieces of information via the following command:
-  
  `./create ~/Documents/CordovaXY/HelloWorld org.apache.cordova.HelloWorld HelloWorld`
+     `./create ~/Documents/CordovaXY/HelloWorld org.apache.cordova.HelloWorld HelloWorld`
 
   ![](img/guide/getting-started/ios/create.png)
 
@@ -117,9 +115,9 @@ Determine where on your system you will locate the Xcode project files for your
 
       **No Developer Directory Found**
 
-      The “Error: No developer directory found at /Developer” message is displayed if the create script can not find the location of the command line tools within Xcode. This can occur if more than one version of Xcode is installed on the system or when upgrading from older versions of Xcode.  The solution is to run the xcode-select command to set the location.  If you have installed Xcode in the default location the command to execute is:

+      The “Error: No developer directory found at /Developer” message is displayed if the create script can not find the location of the command-line tools within Xcode. This can occur if more than one version of Xcode is installed on the system or when upgrading from older versions of Xcode.  The solution is to run the xcode-select command to set the location.  If you have installed Xcode in the default location the command to execute is:
 
-            sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer

+            sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer
 
       See [http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html](http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html) for more information on the xcode-select command if you have installed Xcode in a different location.
 
@@ -127,59 +125,59 @@ Determine where on your system you will locate the Xcode project files for your
 
   - **Additional Parameters**
 
-  The default create script copies the necessary common library files from the Cordova distribution directory into your Xcode project directory.  These files will appear within the CordovaLib directory of your project structure.  Some development organizations prefer to have developers reference the common Cordova library files from a fixed location.  A common location helps to insure that all developers are using the exact same copy of the CordovaLib code.  This is accomplished by adding the --shared parameter to the create command.  The following command will create a project that references the CordovaLib directory from the iOS directory location where the create script is executed:

+  The default create script copies the necessary common library files from the Cordova distribution directory into your Xcode project directory.  These files appear within the project's `CordovaLib` directory.  Some development organizations prefer that developers reference the common Cordova library files from a fixed location, which helps ensure that all developers use the exact same copy of the CordovaLib code.  To do this, add the `--shared` parameter to the `create` command.  The following command creates a project that references the CordovaLib directory from the iOS directory location in which you run the `create` script:
 
-        ./create --shared ~/Documents/CordovaXY/HelloWorld org.apache.cordova.HelloWorld HelloWorld

-  
  The Xcode project is still created in the ~/Documents/CordovaXY/HelloWorld directory, but it references the CordovaLib files from the fixed location of the Cordova distribution rather than a copy of these files within the project directory. 

+        ./create --shared ~/Documents/CordovaXY/HelloWorld org.apache.cordova.HelloWorld HelloWorld
+     The Xcode project files are still in the `~/Documents/CordovaXY/HelloWorld` directory, but the CordovaLib files are referenced from the Cordova distribution directory.
   - **Additional Scripts**
 
-  Within the cordova-ios/bin directory there is an additional script that changes the location of the CordovaLib directory to refer to a shared location after the project has been created,

+  Within the cordova-ios/bin directory there is an additional script that changes the location of the CordovaLib directory to refer to a shared location after the project has been created,
 
-         ./update_cordova_subproject path/to/your/project

+         ./update_cordova_subproject path/to/your/project
 
-  Most users will be satisfied with the default project creation procedure and do not need this additional script. This script uses the location of CordovaLib directory at the same directory level as the bin directory from which it is run as the shared location for CordovaLib. To modify the newly created HelloWorld project to use a shared location for CordovaLib, execute the following command from the bin directory:

+  Most users are satisfied with the default project creation procedure and do not need this additional script. This script uses the location of CordovaLib directory at the same directory level as the bin directory from which it is run as the shared location for CordovaLib. To modify the newly created HelloWorld project to use a shared location for CordovaLib, execute the following command from the `bin` directory:
 
-        ./update_cordova_subproject ~/Documents/CordovaXY/HelloWorld

+        ./update_cordova_subproject ~/Documents/CordovaXY/HelloWorld
 
 ## Running the Application
 
 ### Open the Project
 
-  Using the Finder app, navigate to the location where you created the project. This guide uses ~/Documents/CordovaXY/HelloWorld.  Double click the HelloWorld.xcodeproj file to open the project in Xcode.
+  Using the Finder app, navigate to the location where you created the project. This guide uses `~/Documents/CordovaXY/HelloWorld`.  Double-click the `HelloWorld.xcodeproj` file to open the project in Xcode.
 
   Your screen should look similar to:
 
 ![](img/guide/getting-started/ios/helloworld_project.png)
-  **Note:** this screen capture shows a project that was created with the name as HelloWorld23.   

+  __NOTE:__ this screen capture shows a project that was created with the name as HelloWorld23.
 ### Deploy to the Simulator
 
-  1. In the upper left hand corner of Xcode, click on the Scheme drop down and select the project name, HelloWorld, as the target.  

-  2. Click the device section and select an iOS Simulator such as iPhone 6.0 Simulator as shown:  

+  1. In the upper-left corner of Xcode, click on the Scheme drop-down list and select the project name, HelloWorld, as the target.
+  2. Click the device section and select an iOS Simulator such as iPhone 6.0 Simulator as shown:
 ![](img/guide/getting-started/ios/select_xcode_scheme.png)
 
-  3. Click the **Run** button in your project window's toolbar to build, deploy and run the application in the simulator. 

+  3. Click the **Run** button in your project window's toolbar to build, deploy and run the application in the simulator.
 
 ### Deploy to the Device
 
 #### Requirements
 
-  There are several requirements to deploy to a device. Since this information is not related directly to Cordova, please refer to the Apple Configuring Development and Distribution Assets section of the [Tools Workflow Guide for iOS](http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959) documentation for complete details.

+  There are several requirements to deploy to a device. Since this information is not related directly to Cordova, please refer to the _Configuring Development and Distribution Assets_ section of Apple's [Tools Workflow Guide for iOS](http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959).
 
-  - Join the Apple iOS Developer Program

+  - Join the Apple iOS Developer Program
 
-  - Create a Provisioning Profile within the [iOS Provisioning Portal](https://developer.apple.com/ios/manage/overview/index.action).   You can use the Development Provisioning Assistant within the Provisioning Portal to create and install the profile and certificate for use within Xcode.

+  - Create a Provisioning Profile within the [iOS Provisioning Portal](https://developer.apple.com/ios/manage/overview/index.action).   You can use the Development Provisioning Assistant within the Provisioning Portal to create and install the profile and certificate for use within Xcode.
 
-  - Verify that the Code Signing Identity in the Code Signing sections of the Hello World Xcode project settings has been set with your provisioning profile name.   

+  - Verify that the Code Signing Identity in the Code Signing sections of the Hello World Xcode project settings has been set with your provisioning profile name.
 
 #### Deployment Steps
 
-  1. Plug your device into your Mac via the USB Cable.

+  1. Plug your device into your Mac via the USB Cable.
   2. Select the Target and device
 
-    1. In the upper left hand corner of Xcode, click the Scheme drop down and select the project name, HelloWorld, as the target.

-    2. Click the device section and select your device from the list.  If your device is plugged in via the USB but not visible in the device list, click the **Organizer** button to determine any errors.

+    1. In the upper-left corner of the Xcode window, click the Scheme drop-down list and select the project name, HelloWorld, as the target.
+    2. Click the device section and select your device from the list.  If your device is plugged in via the USB but not visible in the device list, click the **Organizer** button to determine any errors.
 
-  3. Click the **run** button to build, deploy and run the application on your device.
+  3. Click the **run** button to build, deploy and run the application on your device.
 
 ## Results
 
@@ -191,11 +189,22 @@ Determine where on your system you will locate the Xcode project files for your
 
 ### Deprecation Warnings
 
-  When an application programming interface (API) has been changed or replaced by another API, it is marked as “deprecated.”  The API will still work in the near term but will be removed in a future version of the code library.  Apache Cordova contains some of these deprecated interfaces.  When you build and deploy an application, Xcode will issue warnings about these deprecated APIs.  The ‘invokeString’ method that Xcode is warning about represents functionality to invoke the app from a custom URL. The process for loading from a custom URL has changed but this code is included to provide backwards functionality for apps created with older versions of Cordova.  The sample app does not use this functionality so the references to the items causing the warnings can be ignored.
-
-  If you wish to remove the warnings you can remove the code that is referencing the invokeString deprecated API. 

-
-  1. Navigate to the MainViewController.m file in the Classes folder.

+When an application programming interface (API) is changed or replaced
+by another API, it is marked as _deprecated_.  The API still works in
+the near term, but is eventually removed.  Some of these deprecated
+interfaces are reflected in Apache Cordova, and Xcode issues warnings
+about them when you build and deploy an application.  The Xcode
+warning about the ‘invokeString’ method concerns functionality that
+launches the app from a custom URL. While the mechanism to load from a
+custom URL has changed, this code is included to provide backwards
+functionality for apps created with older versions of Cordova.  The
+sample app does not use this functionality, so these warnings can be
+ignored.
+
+If you wish to remove the warnings you can remove the code that
+references the deprecated invokeString API:
+
+  1. Edit the `Classes/MainViewController.m` file.
   2. Find and comment out the following code by surrounding it with the begin, /*,  and end, */, comment characters as highlighted in the code snippet below.
 
         (void)webViewDidFinishLoad:(UIWebView*)theWebView
@@ -211,30 +220,30 @@ Determine where on your system you will locate the Xcode project files for your
         */
         // Black base color for background matches the native apps
         theWebView.backgroundColor = [UIColor blackColor];
-        
+
         return [super webViewDidFinishLoad:theWebView];
         }
-    
-  3. Press Command s to save the file. 

+
+  3. Press Command s to save the file.
   4. Navigate to the AppViewDelegate.m file in the Classes Folder.
 
-  5. Comment out the following line by placing a double slash at the beginning of line 73 as shown below:

+  5. Comment out the following line by placing a double slash at the beginning of line 73 as shown below:
 
-        //self.viewController.invokeString = invokeString;

+        //self.viewController.invokeString = invokeString;
 
   6. Press Command-s to save the file.
 
-  7. Press Command-b to rebuild the project and eliminate the warnings.

+  7. Press Command-b to rebuild the project and eliminate the warnings.
 
 ### Missing Headers
 
-  Some users have encountered compilation errors relating to missing headers.  This refers to a problem in the build location and is fixed via Xcode preferences. 

+  Some users have encountered compilation errors relating to missing headers.  This refers to a problem in the build location and is fixed via Xcode preferences.
 
-  1.  Within the Xcode menus select **Xcode>Preferences>Locations**. 

-  2. In the Derived Data section click the Advanced button and select Unique as the Build Location as shown: 

+  1.  Within the Xcode menus select **Xcode → Preferences → Locations**.
+  2. In the __Derived Data__ section click the __Advanced__ button and select __Unique__ as the __Build Location_ as shown:
 ![](img/guide/getting-started/ios/xcode_build_location.png)
 
-  This is the default setting for a new Xcode install but it may have been set differently if you upgraded from an older version of Xcode.
+  This is the default setting for a new Xcode install, but it may be set differently if you upgraded from an older version of Xcode.
 
 ## Next Steps
 
@@ -242,19 +251,19 @@ Determine where on your system you will locate the Xcode project files for your
 
   **Include Cordova**
 
-  All of the code for the sample application is contained within the www directory in the Xcode project structure.  The starting page is named index.html.  Any page that uses Cordova must include the cordova-*.js file for the associated Cordova version and platform.  The format of the JavaScript file name is cordova-x.y.z where x represents the major version number, y the minor version and z any point release.  For example, the Cordova 2.2.0 file was named cordova-2.2.0.js.   The sample HelloWorld application includes this file from index.html.
+  All of the code for the sample application is contained within the `www` directory in the Xcode project structure.  The starting page is named index.html.  Any page that uses Cordova must include the cordova-*.js file for the associated Cordova version and platform.  The format of the JavaScript file name is cordova-x.y.z where x represents the major version number, y the minor version and z any point release.  For example, the Cordova 2.2.0 file was named cordova-2.2.0.js.   The sample HelloWorld application includes this file from index.html.
 
       <script type="text/javascript" src="cordova-2.2.0.js"></script>
       <script type="text/javascript" src="js/index.js"></script>
       <script type="text/javascript">
               app.initialize();
       </script>
-    
+
   **Wait for deviceReady Event**
 
-  When loading a page, Cordova’s deviceReady event must fire before you can access any of the platform features via the Cordova JavaScript APIs.  Within the sample application this is set up within the app object found within the js/index.js file. The app.initialze() call at the bottom of the index.html file (visible in the previous code example) sets in motion the binding of events to receive and respond to the deviceReady event.
+  When loading a page, Cordova’s `deviceReady` event must fire before you can access any of the platform features via the Cordova JavaScript APIs.  Within the sample application this is set up within the app object found within the js/index.js file. The app.initialze() call at the bottom of the `index.html` file (visible in the previous code example) sets in motion the binding of events to receive and respond to the `deviceReady` event.
 
-  Another common method of initializing a page is to add an event listener for the deviceReady event within the handler for the body onload event as shown in the code snippet below:
+  Another common way to initialize a page is to add a `deviceReady` event listener from the body's `onload` event handler as shown below:
 
       <head>
         <script type="text/javascript" src="cordova-x.x.x.js"></script>
@@ -279,10 +288,9 @@ Determine where on your system you will locate the Xcode project files for your
         <body onload=”onLoad();”>
         .....
 
-
 ###Code Your Application
 
-  Replace the sample code in the www directory of a new project with the HTML, JavaScript and CSS code for your application.  The name of the initial file to load when the app is launched should be index.html (advanced users can change this if necessary).  As demonstrated in the HelloWorld sample application, subdirectories within the www directory are permitted.  Note that the www directory is readonly, you can not write information to this directory during app execution.  If you need to store information use the Cordova File or Storage APIs.
+  Replace the sample code in the `www` directory of a new project with the HTML, JavaScript and CSS code for your application.  The name of the initial file to load when the app is launched should be `index.html` (advanced users can change this if necessary).  As demonstrated in the HelloWorld sample application, subdirectories within the `www` directory are permitted.  Note that the `www` directory is readonly, you can not write information to this directory during app execution.  If you need to store information use the Cordova File or Storage APIs.
 
   You can use many mobile JavaScript frameworks with Cordova  to create the UI and page navigation of your application.  Popular ones include:
 
@@ -300,24 +308,22 @@ Determine where on your system you will locate the Xcode project files for your
 
 ### Apple
 
+  Some of these references are within the Apple iOS Developer Reference and require an iOS Developer License.
 
-  Some of these references are within the Apple iOS Developer Reference and require an iOS Developer License.

-
-  - [Start Developing iOS Apps Today](http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343) provides a quick overview of steps for developing iOS Apps.

-  - [Member Center home page](https://developer.apple.com/membercenter/index.action) provides links to several iOS technical resources including technical resources, the provisioning portal, distribution guides and community forums. 

-  - [Tools Workflow Guide for iOS](http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959) 

-  - [Xcode 4 User Guide](http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215) 

+  - [Start Developing iOS Apps Today](http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343) provides a quick overview of steps for developing iOS Apps.
+  - [Member Center home page](https://developer.apple.com/membercenter/index.action) provides links to several iOS technical resources including technical resources, the provisioning portal, distribution guides and community forums.
+  - [Tools Workflow Guide for iOS](http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959)
+  - [Xcode 4 User Guide](http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215)
   - [Session Videos](https://developer.apple.com/videos/wwdc/2012/) from the Apple World Wide Developer Conference 2012 (WWDC2012)
 
 ### Apache Cordova
 
   The [Apache Cordova home page](http://cordova.apache.org/) contains all of the links below and more.
 
-  - Cordova API documentation is available at [http://docs.cordova.io](http://docs.cordova.io)

-  - [PhoneGap google group](https://groups.google.com/forum/?fromgroups=%23!forum/phonegap) to discuss and ask questions about Cordova.  This forum is monitored by Cordova developers as well as users.  When posting please include the platform, device type, Cordova version and as many details as possible about the error or problem. 

+  - Cordova API documentation is available at [http://docs.cordova.io](http://docs.cordova.io)
+  - [PhoneGap google group](https://groups.google.com/forum/?fromgroups=%23!forum/phonegap) to discuss and ask questions about Cordova.  This forum is monitored by Cordova developers as well as users.  When posting please include the platform, device type, Cordova version and as many details as possible about the error or problem.
   - File Cordova bugs at [https://issues.apache.org/jira/browse/CB](https://issues.apache.org/jira/browse/CB)
 
-
 ### Credits
-    
+
   Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® and  Finder® are Trademarks of Apple Inc.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/symbian/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/symbian/index.md b/docs/en/edge/guide/getting-started/symbian/index.md
index d73ad92..dd865f7 100644
--- a/docs/en/edge/guide/getting-started/symbian/index.md
+++ b/docs/en/edge/guide/getting-started/symbian/index.md
@@ -27,7 +27,6 @@ Video Tutorials:
 
 - [Cordova Installer - Xcode 4 Template](http://www.youtube.com/v/R9zktJUN7AI?autoplay=1)
 
-
 1. Requirements
 ---------------
 
@@ -35,42 +34,36 @@ Video Tutorials:
 
 There are also [QT for Symbian](http://wiki.phonegap.com/w/page/16494811/PhoneGap-Symbian-%28Qt%29) and [Symbian with Sony Ericsson](http://wiki.phonegap.com/w/page/16494782/Getting-Started-with-PhoneGap-Symbian-(WRT-on-Sony-Ericsson)) guides.
 
-
 2. Install SDK + Cordova
 -------------------------
 
-- Download and install [cygwin](http://www.cygwin.com/setup.exe) (Windows only). Make sure you select "make" as it is not included by default
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the Android directory.
-
+- Download and install [cygwin](http://www.cygwin.com/setup.exe) (Windows only). Make sure you select `make` as it is not included by default.
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the Android directory.
 
-3. Setup New Project
+3. Set up New Project
 --------------------
 
 - In cygwin, navigate to where you extracted Cordova and go into the Symbian directory</li>
 
- 
 4. Hello World
 --------------
 
-- Open up index.html located in phonegap/symbian/framework/www with your favourite editor. 
-- In the `body` tag, remove the line `"Build your phonegap app here! Dude!"` and add the line `<h1>Hello World</h1>`
-- In cygwin/terminal, type make. This will produce phonegap-symbian.wrt/app.wgz. 
-
+- Edit the `index.html` file located in `phonegap/symbian/framework/www`.
+- In the `body` tag, remove the line `Build your phonegap app here! Dude!` and add the line `<h1>Hello World</h1>`
+- In `cygwin/terminal`, type `make`. This produces a `phonegap-symbian.wrt/app.wgz` file.
 
 5A. Deploy to Simulator
 -----------------------
 
-- For Mac or Linux you should install [Aptana Studio](http://www.aptana.org/products/studio2/download) and [Nokia WRT Plug-in for Aptana Studio](http://www.forum.nokia.com/info/sw.nokia.com/id/00d62bd8-4214-4c86-b608-5f11b94dad54/Nokia_WRT_Plug_in_for_Aptana_Studio.html). This has a browser-based javascript emulator
+- For Mac or Linux you should install [Aptana Studio](http://www.aptana.org/products/studio2/download) and [Nokia WRT Plug-in for Aptana Studio](http://www.forum.nokia.com/info/sw.nokia.com/id/00d62bd8-4214-4c86-b608-5f11b94dad54/Nokia_WRT_Plug_in_for_Aptana_Studio.html). This has a browser-based JavaScript emulator
 - For Windows you can download the [S60 SDK](http://www.forum.nokia.com/info/sw.nokia.com/id/ec866fab-4b76-49f6-b5a5-af0631419e9c/S60_All_in_One_SDKs.html) which includes the S60 Emulator
 - Load the phonegap-symbian.wrt/app.wgz file into the emulator.
 
-
 5B. Deploy to Device
 --------------------
 
 - Load the phonegap-symbian.wrt/app.wgz file into the device using bluetooth or email.
 
-
 Done!
 -----
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/tizen/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/tizen/index.md b/docs/en/edge/guide/getting-started/tizen/index.md
index a45895e..0f9b268 100644
--- a/docs/en/edge/guide/getting-started/tizen/index.md
+++ b/docs/en/edge/guide/getting-started/tizen/index.md
@@ -31,15 +31,15 @@ This guide describes how to set up your development environment for Cordova and
 -------------------------
 
 - Download and install the [Tizen SDK](https://developer.tizen.org/sdk).
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the tizen directory.
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `tizen` directory.
 - (optional) Install Tizen Cordova template projects: copy the `/templates` directory content into you Tizen Eclipse IDE web templates directory (e.g: `/home/my_username/tizen-sdk/IDE/Templates/web`).
 
-3. Setup New Project
+3. Set up New Project
 --------------------
 
 - **Method #1: Import a Cordova Tizen project sample**
     - Launch Tizen Eclipse IDE
-    - Select  **File** -> **Import** -> **Tizen Web Project**
+    - Select  **File &rarr; Import &rarr; Tizen Web Project**
 
     ![](img/guide/getting-started/tizen/import_project.png)
 
@@ -47,7 +47,7 @@ This guide describes how to set up your development environment for Cordova and
     - Make sure that **Select root directory** is checked
     - Make sure **Copy projects into workspace** is checked
     - Click **Browse**
-    - Browse to one of the Cordova Tizen "samples" project directory (e.g: `/cordova-basic`) and select it
+    - Browse to one of the Cordova Tizen `samples` project directory (e.g: `/cordova-basic`) and select it
 
     ![](img/guide/getting-started/tizen/import_widget.png)
 
@@ -55,14 +55,14 @@ This guide describes how to set up your development environment for Cordova and
 
     ![](img/guide/getting-started/tizen/project_explorer.png)
 
-    - Your project should now have been imported and appear **Project Explorer** view
+    - Your project should now be imported and appear in the **Project Explorer** view
 
 - **Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates**
     - Launch Tizen Eclipse IDE
-    - Select  **File** -> **New** -> **Tizen Web Project**
+    - Select  **File &rarr; New &rarr; Tizen Web Project**
     - Select **User Template** and **User defined** items
     - Select one of the Tizen Cordova template (e.g: **CordovaBasicTemplate**)
-    - Fill-up the **Project name** and its target **Location**
+    - Fill the **Project name** and its target **Location**
 
     ![](img/guide/getting-started/tizen/project_template.png)
 
@@ -70,7 +70,7 @@ This guide describes how to set up your development environment for Cordova and
 
     ![](img/guide/getting-started/tizen/project_explorer.png)
 
-    - Your project should now have been created and appear **Project Explorer** view
+    - Your project should now appear in the **Project Explorer** view
 
 4. Hello World
 --------------
@@ -80,10 +80,9 @@ This guide describes how to set up your development environment for Cordova and
 
     ![](img/guide/getting-started/tizen/build_project.png)
 
-    - A widget package should have been generated in your project root directory (e.g: `cordova-basic.wgt`)
-
-    - **Note** that the provided samples Tizen Cordova projects are not basic hello world applications. They contain a simple example usage of the Battery Cordova API.
+    - A widget package should be generated in your project root directory (e.g: `cordova-basic.wgt`)
 
+    - __NOTE:__ The provided samples Tizen Cordova projects are not basic hello world applications. They contain a simple example usage of the Battery Cordova API.
 
 5A. Deploy to Simulator
 -----------------------
@@ -95,12 +94,12 @@ This guide describes how to set up your development environment for Cordova and
 5B. Deploy to Device/Emulator
 --------------------
 
-- Make sure that your target device is properly launched/connected/configured ("Date and Time" settings must have been set correctly)
-- Select your application deployment target with the **Connection Explorer** view (Select **Window** Menu -> **Show View** -> **Connection Explorer** )
+- Make sure that your target device is properly launched, connected and configured. Its __Date and Time__ settings must be set correctly.
+- Select your application deployment target with the **Connection Explorer** view (Select **Window &rarr; Show View &rarr; Connection Explorer**.)
 
     ![](img/guide/getting-started/tizen/connection_explorer.png)
 
-- **Right Click** your project in the **Project Explorer** view and Select **Run As** and **Tizen Web Application**
+- **Right-click** your project in the **Project Explorer** view and select **Run As** and **Tizen Web Application**
 
     ![](img/guide/getting-started/tizen/runas_web_app.png)
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/webos/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/webos/index.md b/docs/en/edge/guide/getting-started/webos/index.md
index 37ab244..71f9740 100644
--- a/docs/en/edge/guide/getting-started/webos/index.md
+++ b/docs/en/edge/guide/getting-started/webos/index.md
@@ -28,35 +28,30 @@ Video Tutorials:
 - [Cordova and HP Palm webOS quick start video](http://www.youtube.com/v/XEnAUbDRZfw?autoplay=1)
 - [How to convert iPhone app to a Palm](http://www.youtube.com/v/wWoJfQw79XI?autoplay=1)
 
-
 1. Requirements
 ---------------
 
 - Windows, OS X, or Linux
 
-
 2. Install SDK + Cordova
 ----------------------------
 
 - Download and install [Virtual Box](http://www.virtualbox.org/)
 - Download and install [WebOS SDK](http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&Itemid=321/)
-- Download and install [cygwin SDK](http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;layout=page&amp;id=1788&amp;Itemid=321)  (Windows only). Make sure you select "make" as it is not included by default
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the webOS directory.
+- Download and install [cygwin SDK](http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;layout=page&amp;id=1788&amp;Itemid=321)  (Windows only). Make sure you select `make` as it is not included by default
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `webOS` directory.
 - Download and install XCode from the [Mac App Store](http://itunes.apple.com/ca/app/xcode/id497799835?mt=12) (OSX only)
-- Download and install Command Line Tools for XCode (OSX only); this can be done by going to XCode's Preferences -> Downloads -> Components and then click install on Command Line Tools
+- Download and install Command Line Tools for XCode (OSX only); this can be done by going to __Preferences &rarr; Downloads &rarr; Components__ and then click install on Command Line Tools
 
- 
-3. Setup New Project
+3. Set up New Project
 --------------------
 
 - Open up terminal/cygwin and navigate to where you extracted your Cordova Download. Go into the webOS directory.
 
-
 4. Hello World
 --------------
 
-In phonegap/webOS/framework/www, open up index.html with your favourite editor. After the body tag add `<h1>Hello World</h1>`
-
+Edit `phonegap/webOS/framework/www/index.html`, adding `<h1>Hello World</h1>` after the `<body>` tag.
 
 5A. Deploy to Simulator
 -----------------------
@@ -64,16 +59,15 @@ In phonegap/webOS/framework/www, open up index.html with your favourite editor.
 - Open up your Palm Emulator from your applications folder/start menu.
 - Type `make` in your terminal/cygwin while in the webOS directory.
 
-
 5B. Deploy to Device
 --------------------
 
 - Make sure your device is in [Developer Mode and plug it in.](http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;id=1552&amp;Itemid=59#dev_mode)
 - Type `make` in your terminal/cygwin while in the webOS directory.
-       
 
 Done!
 -----
 
-You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/16494781/Getting-Started-with-PhoneGap-webOS).
+A more detailed version of this guide is available
+[here](http://wiki.phonegap.com/w/page/16494781/Getting-Started-with-PhoneGap-webOS).
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/windows-8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/windows-8/index.md b/docs/en/edge/guide/getting-started/windows-8/index.md
index 1c2a6ad..efa0fb8 100644
--- a/docs/en/edge/guide/getting-started/windows-8/index.md
+++ b/docs/en/edge/guide/getting-started/windows-8/index.md
@@ -20,9 +20,15 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 Getting Started with Windows 8
 ==================================
 
-This guide describes how to set up your development environment for Cordova and run a sample application.  Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name.
+This guide describes how to set up your Cordova development
+environment and run a sample application.  Note that Cordova used to
+be called PhoneGap, so some of the sites still use the old PhoneGap
+name.
 
-During development of Windows 8 and Windows RT, Microsoft deprecated the name "Metro-style apps". On MSDN, this type of app is now called a "Windows Store" app. That's the name that we'll use in this guide. Also in this guide whenever we refer to Windows 8, you should take that to mean both Windows 8 and Windows RT.
+Microsoft deprecated the name _Metro-style apps_ in Windows 8 and
+Windows RT. MSDN now refers to this type of app as a _Windows Store_
+app, and this guide follows that convention. Also, in this guide
+_Windows 8_ signifies both Windows 8 and Windows RT.
 
 1. Requirements
 ---------------
@@ -36,26 +42,28 @@ Follow the instructions [here](http://www.windowsstore.com/) to submit your apps
 2. Install SDK + Cordova
 ----------------------------
 
-- Setup your preferred variant of Visual Studio 2012. All of the paid versions of the product (Professional, etc) let you build Windows Store apps. To build Windows Store apps using the [Express editions](http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products), you will need **Express for Windows 8**.
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the subfolder **lib\windows-8**.
+- Set up your preferred variant of Visual Studio 2012. All of the product's paid versions (Professional, etc.) let you build Windows Store apps. You need **Express for Windows 8** to build Windows Store apps using the [Express editions](http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products).
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `lib\windows-8` subfolder.
 
-3. Setup New Project
+3. Set up New Project
 --------------------
 
-You can already build Windows 8 apps using the "HTML/JavaScript track" available in Windows Store apps. The purpose of Cordova in Windows Store apps is to expose the same APIs used on all the other Cordova platforms.
+You can already build Windows 8 apps using the _HTML/JavaScript track_
+available in Windows Store apps. Use Cordova in Windows Store apps to
+expose the same APIs as on other Cordova-supported platforms.
 
 - Open Visual Studio 2012 and choose **New Project**.
-- Select **Installed - Template - Other Languages - JavaScript - Windows Store** from the tree, and then **Blank App** from the projects list. Enter whatever project name you like. We're using **CordovaWin8Foo** in this guide.
+- Select **Installed &rarr; Template &rarr; Other Languages &rarr; JavaScript &rarr; Windows Store** from the tree, and then **Blank App** from the projects list. Enter whatever project name you like, such as **CordovaWin8Foo** as in this example.
 
     ![](img/guide/getting-started/windows-8/wsnewproject.png)
 
-- Microsoft continues to use **default.html** as the default page for use in websites, whereas most "open web" developers use **index.html**. (Plus it's likely that in the other platform variants of your project you are using **index.html** as the name of your default page.) To fix this, in Solution Explorer rename the **default.html** file to **index.html**. Then double-click the **package.appxmanifest** file and change the **Start page** value to **index.html**. 
+- Microsoft continues to use `default.html` as the default home page, but most web developers use `index.html`. (Plus it's likely that in the other platform variants of your project you are using `index.html` as the name of your default page.) To fix this, in Solution Explorer rename the `default.html` file to `index.html`. Then double-click the `package.appxmanifest` file and change the **Start page** value to `index.html`.
 
 	![](img/guide/getting-started/windows-8/wschangemanifest.png)
 
-- To include **cordova.js** in your project, right-click on the **js** folder in Solution Explorer and select **Add - New Item**. Locate the **cordova.js** file in the **lib\windows-8** folder that we called out previously. 
+- To include `cordova.js` in your project, right-click on the **js** folder in Solution Explorer and select **Add &rarr; New Item**. Locate the `cordova.js` file in the **lib\windows-8** folder noted above.
 
-- Edit the code for **index.html**. Add a reference to **cordova.js**. You can do this manually, or by dragging the file from Solution Explorer.
+- Edit the code for `index.html`. Add a reference to `cordova.js`. You can do this manually, or by dragging the file from Solution Explorer.
 
 ### Adding the reference...
 	    <!-- WinJS references -->
@@ -70,7 +78,7 @@ You can already build Windows 8 apps using the "HTML/JavaScript track" available
 	    <link href="/css/default.css" rel="stylesheet" />
 	    <script src="/js/default.js"></script>
 
-- Next we want to add some code that will demonstrate that Cordova is working. 
+- Next, add some code that demonstrates Cordova is working.
 
 ### Adding a 'deviceready' handler...
 	<body>
@@ -89,11 +97,10 @@ You can already build Windows 8 apps using the "HTML/JavaScript track" available
 
 	</body>
 
-
 5. Test the Project
 -------------------------------
 
-- Run the project from Visual Studio. You'll see the message box appear.
+- Run the project from Visual Studio. You'll see the message box appear:
 
 	![](img/guide/getting-started/windows-8/wsalert.png)
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/windows-phone-7/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/windows-phone-7/index.md b/docs/en/edge/guide/getting-started/windows-phone-7/index.md
index 3a8f81f..95c45ea 100644
--- a/docs/en/edge/guide/getting-started/windows-phone-7/index.md
+++ b/docs/en/edge/guide/getting-started/windows-phone-7/index.md
@@ -28,89 +28,81 @@ Video Tutorials:
 - [Cordova and Windows Phone quick setup video](http://www.youtube.com/v/wO9xdRcNHIM?autoplay=1)
 - [Cordova and Windows Phone deep dive](http://www.youtube.com/v/BJFX1GRUXj8?autoplay=1)
 
-
 1. Requirements
 ---------------
 
 - Windows 7, Windows 8 or Windows Vista with SP2
 
-Note: Running in VM has issues, if you are on a Mac, you will need to setup a bootcamp partition with Windows 7 or Vista
-
-Necessary for Installing on Device and Submitting to Market Place:
-
-- Become an [App Hub member](http://create.msdn.com/en-US/home/membership).
+__NOTE:__ Running in VM does not work well. If you are on a Mac, you need to set up a bootcamp partition with Windows 7 or Vista.
 
+- Become an [App Hub member](http://create.msdn.com/en-US/home/membership). You need to do so to install onto a device and submit the application to the market place.
 
 2. Install SDK + Cordova
 ----------------------------
 
 - Download and install [Windows Phone  SDK](http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=27570/)
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the subfolder: lib\windows-phone\
-- copy the file CordovaWP7_x_x_x.zip to the folder : \My Documents\Visual Studio 2012\Templates\ProjectTemplates
-( if the template file does not exist, you will need to build it. See 2.1 below )
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `lib\windows-phone` subfolder.
+- Copy the `CordovaWP7_x.x.x.zip` to the `\My Documents\Visual Studio 2012\Templates\ProjectTemplates\` folder.
+(If the template file does not exist, you need to build it as described in 2.1 below.)
 if you have just installed VisualStudio, you should launch it once to create this folder
-if you prefer, you may add the project instead to the "Silverlight for Windows Phone" subfolder of "Visual C#". This is up to you, and only affects where the project template is shown when creating a new project. Also, You may need to create this folder. 
-
+if you prefer, you may add the project instead to the `Silverlight for Windows Phone` subfolder of `Visual C#`. This is up to you, and only affects where the project template is shown when creating a new project. Also, You may need to create this folder.
 
 2.1. Building the template
 -----------------------------
-( note, this step may not be required.  If the lib\windows-phone directory already contains a file CordovaWP7_x_x_x.zip then you may skip this step )
-- Open the file lib\windows-phone\templates\standalone\CordovaSolution.sln in Visual Studio Express for Windows Phone
-- From the file menu, select 'Export Template...' 
-- Choose template type 'Project template'
-- Give the exported template a name, ex. CordovaStarter-2.1.0 will produce CordovaStarter-2.1.0.zip
-- Optionally, you may add a description, icon image, and Preview image.  These are what is displayed in Visual Studio in the 'New Project' dialog.- 
-- Note: If you select ( 'Automatically import the template ... ') then you will not need to copy the .zip file over as outlined in step 2.
-- Press 'Finish'
 
+__NOTE:__ Skip this step if the `lib\windows-phone` directory already contains a `CordovaWP7_x.x.x.zip` file.
 
+- Open the `lib\windows-phone\templates\standalone\CordovaSolution.sln` in Visual Studio Express for Windows Phone
+- Select __Export Template...__ from the __File__ menu.
+- Choose template type __Project template__
+- Supply a name of the exported template, such as `CordovaStarter-2.1.0` to produce a `CordovaStarter-2.1.0.zip` file.
 
+- Optionally, add a description, icon image, or Preview image.  These are displayed in Visual Studio's __New Project__ dialog.
+- __NOTE:__ If you select __Automatically import the template...__, then you don't need to copy the `.zip` file over as outlined in step 2.
+- Press __Finish__.
 
-3. Setup New Project
+3. Set up New Project
 --------------------
 
 - Open Visual Studio Express for Windows Phone and choose **New Project**.
-- Select **CordovaStarter**. ( the version number will be displayed in the template description )
-- - note: If you do not see it, you may have to select the top level 'Visual C#' to see it
-- Give your project a name, and select OK.
+- Select **CordovaStarter**. (The version number displays in the template description.)
+- - __NOTE:__ If you do not see it, you may have to select the top-level 'Visual C#'.
+- Give your project a name, and select __OK__.
 
     ![](img/guide/getting-started/windows-phone-7/wpnewproj.png)
 
- 
 4. Review the project structure
 -------------------------------
 
 - The 'www' folder contains your Cordova html/js/css and any other resources included in your app.
-- Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content. 
+- Any content that you add needs to be a part of the Visual Studio project, and it must be set as content.
 
     ![](img/guide/getting-started/windows-phone-7/wp7projectstructure.png)
 
-
 5. Build and Deploy to Emulator
 -------------------------------
 
-- Make sure to have **Windows Phone Emulator** selected in the top drop-down menu.
-- Hit the green **play button** beside the Windows Phone Emulator drop-down menu to start debugging or press F5.
+- Make sure **Windows Phone Emulator** is selected in the main drop-down menu.
+- Press the green **play** button next to the drop-down menu to start debugging, or else type __F5__.
 
     ![](img/guide/getting-started/windows-phone-7/wprun.png)
     ![](img/guide/getting-started/windows-phone-7/wpfirstrun.png)
 
-
 6. Build your project for the device
 ------------------------------------
 
-In order to test your application on a device, the device must be registered. Click [here][register-url] to read documentation on deploying and testing on your Windows Phone.
+To test your application on a device, the device must be registered. MSDN provides [documentation][register-url] to help deploy and test your Windows Phone.
 
 - Make sure your phone is connected, and the screen is unlocked
 - In Visual Studio, select 'Windows Phone Device' from the top drop-down menu.
-- Hit the green **play button** beside the drop-down menu to start debugging or press F5.
+- Press the green **play** button next to the main drop-down menu to start debugging, or type __F5__.
 
     ![](img/guide/getting-started/windows-phone-7/wpd.png)
 
-
 Done!
 -----
 
 You can also checkout more detailed version of this guide [here](http://wiki.phonegap.com/w/page/48672055/Getting%20Started%20with%20PhoneGap%20Windows%20Phone%207).
 
 [register-url]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
+

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/getting-started/windows-phone-8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/getting-started/windows-phone-8/index.md b/docs/en/edge/guide/getting-started/windows-phone-8/index.md
index e69c7aa..d59d113 100644
--- a/docs/en/edge/guide/getting-started/windows-phone-8/index.md
+++ b/docs/en/edge/guide/getting-started/windows-phone-8/index.md
@@ -22,12 +22,12 @@ Getting Started with Windows Phone 8
 
 This guide describes how to set up your development environment for Cordova and run a sample application.  Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name.
 
-Note: Applications built with Apache Cordova for Windows Phone 8 will only run on Windows Phone 8 devices. If you are looking to target both 7.5 AND 8 devices, then you should be using Apache Cordova for Windows Phone 7, which does not have all the new shiny features included in IE10, but implements the same APIs.
+__NOTE:__ Applications built with Apache Cordova for Windows Phone 8 run only on Windows Phone 8 devices. If you want to target both 7.5 'and' 8 devices, then use Apache Cordova for Windows Phone 7, which does not have all the advanced features included in IE10, but implements the same APIs.
 
 1. System Requirements
 ---------------
 
-- Operating System: 
+- Operating System:
     - Windows 8 or Windows 8 Pro
         - The 64-bit version (x64) of Windows is required for the SDK.
         - The Pro version is recommended so you can run a device emulator.
@@ -38,96 +38,98 @@ Note: Applications built with Apache Cordova for Windows Phone 8 will only run o
     - 64-bit (x64) CPU
 
 - Windows Phone 8 Emulator
-    - The phone emulator uses Hyper-V, so this list includes those pre-reqs.
+    - The phone emulator uses Hyper-V, so this list includes those pre-requisites.
     - Windows 8 Pro 64-bit edition or greater
     - Requires a processor that supports virtualization and [Second Level Address Translation (SLAT)](http://en.wikipedia.org/wiki/Second_Level_Address_Translation)
         - See the [list of Intel processors that support VT-x (virtualization) and EPT (SLAT)](http://ark.intel.com/Products/VirtualizationTechnology)
     - Enable the virtualization capability (i.e., VT-x on Intel) in your BIOS settings, as usually this is disabled by default.
 
 - SDK + IDE ( Visual Studio )
-    - Visual Studio 2012 Professional, Premium, or Ultimate. Note that Visual Studio Express for Windows Phone (included in the SDK) is not recommended because you can not build the template (see below) with VS Express, as it does not have the "Export Template" functionality, which is only in VS Pro or higher.
+    - Visual Studio 2012 Professional, Premium, or Ultimate. Note that Visual Studio Express for Windows Phone (included in the SDK) is not recommended because you can not build the template (see below) with VS Express, as it does not have the __Export Template__ functionality, which is only in VS Pro or higher.
 
 - Register and pay for a [Windows Phone Dev Center](http://dev.windowsphone.com/en-us/publish) account if you want to install your app on a real device and/or submit it to Market Place.
 
-Note: Running the SDK in Virtual Machine might present some challenges. You can read this blog post that gives insight on the solutions to develop for [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac).
-
+__NOTE:__ Running the SDK in Virtual Machine might present some challenges. You can read this blog post that gives insight on the solutions to develop for [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac).
 
 2. Install SDK + Cordova
 ----------------------------
 
 - Download and install [Windows Phone SDK](http://www.microsoft.com/en-us/download/details.aspx?id=35471)
-- Download the latest copy of [Cordova](http://phonegap.com/download) and extract its contents. We will be working with the subfolder: lib\windows-phone-8\
-- copy the file CordovaWP8_x_x_x.zip to the folder : \My Documents\Visual Studio 2012\Templates\ProjectTemplates\
-
+- Download and extract the latest copy of [Cordova](http://phonegap.com/download). You will be working in the `lib\windows-phone-8` subfolder.
+- Copy the file CordovaWP8_x_x_x.zip to the folder : \My Documents\Visual Studio 2012\Templates\ProjectTemplates\
 
 2.1. Building the template
 -----------------------------
-Note: this step may not be required.  If the lib\windows-phone directory already contains a file CordovaWP8_x_x_x.zip then you may skip this step.
-
-In order to simplify the development process, Cordova comes with a Visual Studio template that allows creating a Cordova application rapidly. This template can be modified if needed and the below steps indicate how to proceed if you want to modify and re-generate the template.
 
-- Open the file lib\windows-phone\templates\standalone\CordovaSolution.sln in Visual Studio Express for Windows Phone
-- From the file menu, select 'Export Template...' 
-- Choose template type 'Project template'
-- Give the exported template a name, ex. CordovaStarter-2.1.0 will produce CordovaStarter-2.1.0.zip
-- Optionally, you may add a description, icon image, and Preview image.  These are what is displayed in Visual Studio in the 'New Project' dialog.- 
-- Note: If you select ( 'Automatically import the template ... ') then you will not need to copy the .zip file over as outlined in step 2.
-- Press 'Finish'
-
-
-2.2 About the template
---------------------
-Apache Cordova for Windows Phone 8 has moved to only supporting the standalone template.
-
-The 'Stand-Alone' template includes ALL the source code for Apache Cordova.  This project is easier to fine-tune to use just the features you need, thereby working around the permissions issues of using the dll.  In order to exclude an API (Plugin) you are not using, you can simply right-click-select the Command class file in Visual Studio and choose 'do not include in project'.
+__NOTE:__ this step may not be required.  If the lib\windows-phone directory already contains a file CordovaWP8_x_x_x.zip then you may skip this step.
 
+In order to simplify the development process, Cordova comes with a Visual Studio template that allows creating a Cordova application rapidly. This template can be modified if needed and the below steps indicate how to proceed if you want to modify and re-generate the template.
 
-3. Setup New Project
+- Open the `lib\windows-phone\templates\standalone\CordovaSolution.sln` file in Visual Studio Express for Windows Phone.
+- Select __Export Template...__ from the __File__ menu.
+- Choose template type __Project template__
+- Give the exported template a name, such as `CordovaStarter-2.1.0`, which produces a `CordovaStarter-2.1.0.zip` archive.
+- Optionally, you may add a description, icon image, and preview image.  These  display in Visual Studio's __New Project__ dialog.
+- __NOTE:__ If you select __Automatically import the template...__, then you don't need to copy the `.zip` file over as outlined in step 2.
+- Press __Finish__
+
+2.2 About the different templates
+---------------------------------
+
+Apache Cordova for Windows Phone 8 only supports the standalone template.
+
+The 'Stand-Alone' template includes _all_ the source code for Apache
+Cordova.  This project is easier to fine-tune to use just the features
+you need, thereby working around the permissions issues of the 'Full'
+template, however this type of project is more difficult to update, as
+you update individual files within your project and manage any
+dependancies yourself.  In order to exclude an unused API, simply
+right-click-select the __Command__ class file in Visual Studio and
+choose __do not include in project__.
+
+3. Set up New Project
 --------------------
 
 - Open Visual Studio Express for Windows Phone and choose **New Project**.
-- Select **CordovaWP8**. ( the version number will be displayed in the template description )
-- Give your project a name, and select OK.
+- Select **CordovaWP8**. (The version number is displayed in the template description.)
+- Give the project a name, and select __OK__.
 
 ![](img/guide/getting-started/windows-phone-8/StandAloneTemplate.png)
 
- 
 4. Review the project structure
 -------------------------------
 
 - The 'www' folder contains your Cordova html/js/css and any other resources included in your app.
-- Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content. 
+- Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content.
 
 ![](img/guide/getting-started/windows-phone-8/projectStructure.png)
 
-
 5. Build and Deploy to Emulator
 -------------------------------
 
-- Make sure to have **Windows Phone Emulator** selected in the top drop-down menu.
-- Hit the green **play button** beside the Windows Phone Emulator drop-down menu to start debugging or press F5.
+- Make sure **Windows Phone Emulator** is selected in the main drop-down menu.
+- Press the green **play** button next to the drop-down menu to start debugging, or type __F5__.
 
 ![](img/guide/getting-started/windows-phone-8/BuildEmulator.png)
 
-
 6. Build your project for the device
 ------------------------------------
 
 In order to test your application on a device, the device must be registered. Click [here][register-url] to read documentation on deploying and testing on your Windows Phone 8.
 
-- Make sure your phone is connected, and the screen is unlocked
+- Make sure your phone is connected, and the screen is unlocked.
 - In Visual Studio, select 'Device' from the top drop-down menu.
-- Hit the green **play button** beside the drop-down menu to start debugging or press F5.
+- Press the green **play** button next to the main drop-down menu to start debugging, or type __F5__.
 
 ![](img/guide/getting-started/windows-phone-7/wpd.png)
 
-
 Done!
 -----
 
-Further Reading 
+Further Reading
 -------
 
 For more details on the specific differences between IE10 and WebKit browsers, and how to support both MS has a helpful [guide here](http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx)
 
 [register-url]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
+

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/overview/apis.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/overview/apis.md b/docs/en/edge/guide/overview/apis.md
new file mode 100644
index 0000000..a2c5d89
--- /dev/null
+++ b/docs/en/edge/guide/overview/apis.md
@@ -0,0 +1,25 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+API Primer
+==========
+
+This section introduces the Cordova APIs and shows how you might use
+them in your application.
+

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/overview/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/overview/index.md b/docs/en/edge/guide/overview/index.md
new file mode 100644
index 0000000..d7a46ff
--- /dev/null
+++ b/docs/en/edge/guide/overview/index.md
@@ -0,0 +1,50 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+Overview
+========
+
+Cordova is an open-source mobile development framework. It allows you
+to use standard web technologies such as HTML5, CSS3, and JavaScript
+for cross-platform development, avoiding each mobile platforms' native
+development language.  Applications execute as a WebView within a
+native wrapper, and rely on standards-compliant Cordova API bindings
+to access the device's sensors, data, and network status.
+
+Cordova also offers features
+
+PhoneGap is a product offering that relies on the Cordova framework.
+Its PhoneGap Build service provides a way to build applications
+remotely without having to run local tools.
+
+Use Cordova if you are:
+
+* a mobile developer and want to extend an application across more
+  than one platform, without having to re-implement it with each
+  platform's language and tool set.
+
+* a web developer and want to deploy a web app that's packaged for
+  distribution in app store portals.
+
+* a developer who wants to blend
+
+How Do You Use It?
+---------------------
+
+There are several ways to build

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/39353f45/docs/en/edge/guide/overview/primer.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/overview/primer.md b/docs/en/edge/guide/overview/primer.md
new file mode 100644
index 0000000..053572b
--- /dev/null
+++ b/docs/en/edge/guide/overview/primer.md
@@ -0,0 +1,22 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+         or more contributor license agreements.  See the NOTICE file
+         distributed with this work for additional information
+         regarding copyright ownership.  The ASF licenses this file
+         to you under the Apache License, Version 2.0 (the
+         "License"); you may not use this file except in compliance
+         with the License.  You may obtain a copy of the License at
+
+           http://www.apache.org/licenses/LICENSE-2.0
+
+         Unless required by applicable law or agreed to in writing,
+         software distributed under the License is distributed on an
+         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+         KIND, either express or implied.  See the License for the
+         specific language governing permissions and limitations
+         under the License.
+---
+
+Command-line Deployment Primer
+==============================
+


Mime
View raw message