Fixes to typos, formatting, verbiage, naming conventions, etc.

Went through the new_docs directory and cleaned up some typos, formatting, verbiage and naming conventions in the documentation. Please feel free to reject any changes that you do not feel are appropriate.

Additionally, I just signed a http://www.elasticsearch.org/contributor-agreement/ 

Please let me know if you need anything additional from me to consider this pull request.