Documentation Improvements (#70)

* Expand idiosyncratic version references to Node and NPM

* Expand CRNA to Create React Native App

Although the full name is wordy, I think it pays to avoid an
initialism here. Create React App's docs always use the full name,
and that's only one word fewer.

* Remove yarn references from tl;dr code example

We can explain the options for running through NPM or Yarn
elsewhere. It is best to avoid any decision overload during the
"oh, how does this thing work phase". Besides if you have Yarn,
then you have NPM and these commands will work.

* Direct links to Getting Started and User Guide

Taking another leaf out of Create React App's book here and adding
the link to these two resources right at the top for hot path
users who know what they're after and just want the link. The User
Guide section is redundant if we just link right through.

* If everything is emphasises, nothing is emphasised

* Specify NPM v3

* Standardise capitalisation

* Move Support and Contact up the order

* Turn Limitations into an FAQ section

* Reorder FAQs

* Reformat FAQ headers and responses

* Remove extra line in code block

Author: Jack Reid

README.md

@@ -2,14 +2,17 @@
 
 Create React Native apps with no build configuration.
 
-## tl;dr
+* [Getting Started](#getting-started)
+* [User Guide](https://github.com/react-community/create-react-native-app/blob/master/react-native-scripts/template/README.md)
+
+Once you're up and running with Create React Native App, visit [this tutorial](https://facebook.github.io/react-native/docs/tutorial.html) for more information on building apps with React Native.
+
+## Quick Overview
 
 Make sure you have Node 6 or later installed. No Xcode or Android Studio installation is required.
 
 ```sh
-# substitute for appropriate yarn commands if it's installed
 $ npm install -g create-react-native-app
-
 $ create-react-native-app my-app
 $ cd my-app/
 $ npm start
@@ -22,10 +25,9 @@ Create React Native App allows you to work with all of the [Components and APIs]
 ## Sections
 
 * [Getting Started](#getting-started)
-* [User Guide](#user-guide)
 * [Philosophy](#philosophy)
-* [Limitations and Capabilities](#limitations-and-capabilities)
 * [Support and Contact](#support-and-contact)
+* [FAQs](#faqs)
 * [Contributing](#contributing)
 
 ## Getting Started
@@ -40,7 +42,7 @@ $ npm install -g create-react-native-app
 $ yarn global add create-react-native-app
 ```
 
-**You'll need to have Node >= 6 on your machine. We strongly recommend using npm >= 3 or a recent version of yarn.**
+You'll need to have Node v6 or later on your machine. We strongly recommend using NPM v3 or later, or a recent version of Yarn.
 
 ### Creating an App
 
@@ -79,39 +81,41 @@ This will start the process of "ejecting" from Create React Native App's build s
 
 **Warning:** Running eject is a **permanent** action. Please use a version control system, such as git, so you can revert back if necessary. An ejected app will require you to have an [Xcode and/or Android Studio environment](https://facebook.github.io/react-native/docs/getting-started.html) set up.
 
-## User Guide
-
-Please refer to the [User Guide](https://github.com/react-community/create-react-native-app/blob/master/react-native-scripts/template/README.md) for more details about CRNA specifically.
-
-Once you're up and running with CRNA, visit [this tutorial](https://facebook.github.io/react-native/docs/tutorial.html) for more information on building apps with React Native. 
-
 ## Philosophy
 
 * **Minimal "Time to Hello World"**: Create React Native App should reduce the setup time it takes to try building a mobile app to the absolute minimum, ideally on par with React web development (especially as seen with [Create React App](https://github.com/facebookincubator/create-react-app)).
 * **Develop on Your Device**: It should be easy to develop on a physical device when you want to test how your app feels and responds to inputs.
 * **One Build Tool**: If you just want to get started with React Native, you shouldn't need to install Xcode, Android Studio, NDKs, or mess with environment variables.
 * **No Lock-In**: You can always "eject" to your own build setup if you need to write custom native code or modify how your app is built.
 
-## Limitations and Capabilities
+## Support and Contact
+
+If you're having issues with Create React Native App, please make sure:
 
-The main limitation of a CRNA project is that it must be written in pure JavaScript and not have any dependencies which rely on custom native code (i.e. ones which require running `react-native link` to work). This allows the projects to load directly on a phone without native compilation, and also means that it's not necessary to install or use Android Studio or Xcode.
+* The issue is not covered in the [Getting Started](https://github.com/react-community/create-react-native-app#getting-started) or [User Guide](https://github.com/react-community/create-react-native-app/blob/master/react-native-scripts/template/README.md) documentation
+* There is not already an [open issue](https://github.com/react-community/create-react-native-app/issues) for your particular problem
+
+If you've checked the documentation and currently open issues, please either open a new GitHub issue, [find @dika10sune on Twitter](https://twitter.com/dika10sune), or ping `dikaiosune` on [Reactiflux](https://www.reactiflux.com/)'s #react-native channel on Discord. **Please do not DM or email project maintainers directly**, as it's very important that support takes place in public locations where others can benefit from the conversation.
+
+## FAQs
+
+### What API specification should I be looking at while developing?
 
 Apps made with Create React Native App support everything in the Components and APIs sections of the [React Native Documentation](https://facebook.github.io/react-native/docs/getting-started.html).
 
 Apps made with Create React Native App also support most of the JavaScript-to-Native APIs provided by the [Expo SDK](https://docs.expo.io/versions/latest/sdk/index.html), since they are loaded by the Expo app.
 
-If you're sure that you need custom native code, please read the [ejecting guide](https://github.com/react-community/create-react-native-app/blob/master/EJECTING.md).
+### What are the limitations of Create React Native App?
 
-If you need to build IPAs and APKs for publishing to the App Store and/or Play Store, you can either eject (see above guide) and build them yourself using Xcode and Android Studio, or you can use a service like [Expo's standalone app builds](https://docs.expo.io/versions/v13.0.0/guides/building-standalone-apps.html) to publish your pure JS app.
+The main limitation of a Create React Native App project is that it must be written in pure JavaScript and not have any dependencies which rely on custom native code (i.e. ones which require running `react-native link` to work). This allows the projects to load directly on a phone without native compilation, and also means that it's not necessary to install or use Android Studio or Xcode.
 
-## Support and Contact
+### What if I want to write custom native code for my app?
 
-If you're having issues with Create React Native App, please make sure:
+If you're sure that you need custom native code, please read the [ejecting guide](https://github.com/react-community/create-react-native-app/blob/master/EJECTING.md).
 
-* The issue is not covered in the [Getting Started](https://github.com/react-community/create-react-native-app#getting-started) or [User Guide](https://github.com/react-community/create-react-native-app/blob/master/react-native-scripts/template/README.md) documentation
-* There is not already an [open issue](https://github.com/react-community/create-react-native-app/issues) for your particular problem
+### How do I get my app into the Play Store/App Store?
 
-If you've checked the documentation and currently open issues, please either open a new GitHub issue, [find @dika10sune on Twitter](https://twitter.com/dika10sune), or ping `dikaiosune` on [Reactiflux](https://www.reactiflux.com/)'s #react-native channel on Discord. **Please do not DM or email project maintainers directly**, as it's very important that support takes place in public locations where others can benefit from the conversation.
+If you need to build IPAs and APKs for publishing to the App Store and/or Play Store, you can either eject (see above guide) and build them yourself using Xcode and Android Studio, or you can use a service like [Expo's standalone app builds](https://docs.expo.io/versions/v13.0.0/guides/building-standalone-apps.html) to publish your pure JS app.
 
 ## Contributing
 

react-native-scripts/template/README.md

@@ -31,7 +31,7 @@ Upgrading to a new version of React Native requires updating the `react-native`,
 
 ## Available Scripts
 
-If yarn was installed when the project was initialized, then dependencies will have been installed via yarn, and you should probably use it to run these commands as well. Unlike dependency installation, command running syntax is identical for yarn and npm at the time of this writing.
+If Yarn was installed when the project was initialized, then dependencies will have been installed via Yarn, and you should probably use it to run these commands as well. Unlike dependency installation, command running syntax is identical for Yarn and NPM at the time of this writing.
 
 ### `npm start`