Merge pull request #1066 from ARMmbed/style-review

Review edits to style.md

Author: Amanda Butler

docs/reference/contributing/guidelines/style.md

@@ -1,6 +1,6 @@
 # Style
 
-The Arm Mbed OS codebase is hosted on GitHub, and you can submit new features or bug fixes. Please follow the [guidelines for GitHub pull requests](#guidelines-for-github-pull-requests) and the [coding style guide](#coding-style) in your submissions.
+The Arm Mbed OS codebase is hosted on GitHub, and you can submit new features or bug fixes. Please follow the [guidelines for GitHub pull requests](../contributing/workflow.html#guidelines-for-github-pull-requests) and the [coding style guide](#coding-style) in your submissions.
 
 <span class="tips">**Tip:** Please also read the [workflow](../contributing/workflow.html) section for a review of the process and legal requirements.</span>
 
@@ -12,7 +12,7 @@ After the code has gone through automated testing, developers will take a look a
 
 Whether you're writing new code or fixing bugs in existing code, please follow the Mbed OS coding style.
 
-Mbed OS follows the [K&R style](https://en.wikipedia.org/wiki/Indent_style#K.26R_style), with at least two exceptions (which can be found in the list below the code sample).
+Mbed OS follows the [K&R style](https://en.wikipedia.org/wiki/Indent_style#K.26R_style), with at least two exceptions (see [Rules](#rules)).
 
 The only exception to this coding style involves third-party code. Third-party code should be added to the `.astyleignore` file located in the Mbed OS root directory.
 
@@ -22,7 +22,7 @@ You can use [Artistic Style (AStyle)](http://sourceforge.net/projects/astyle/fil
 astyle -n --options=.astylerc $(full_path_to_file)
 ```
 
-File `.astylerc` defines Mbed OS code style and it's located in Mbed OS root directory.
+File `.astylerc` defines Mbed OS code style and it's in the Mbed OS root directory.
 
 ### Code sample
 
@@ -67,6 +67,7 @@ uint32_t adc_function(analogin_t *obj, uint32_t options)
     return adc_hal_get_conversion_value(instance, 0);
 }
 ```
+
 ### Rules
 
 - Indentation - four spaces. Please do not use tabs.
@@ -105,13 +106,13 @@ uint32_t adc_function(analogin_t *obj, uint32_t options)
 
 #### Classes
 
-- Begins with a capital letter, and each word in it also begins with a capital letter (AnalogIn, BusInOut).
+- Begin with a capital letter, and each word within a class also begins with a capital letter (AnalogIn, BusInOut).
 
 - Methods contain small letters, with words separated by underscore.
 
-- Private members starts with an underscore: ``__User defined types (typedef)))``.
+- Private members start with an underscore: ``__User defined types (typedef)))``.
 
-- Structures - `suffix _t` - to denote it is a user defined type.
+- Structures - `suffix _t` - to denote it is a user-defined type.
 
 - Enumeration - the type name and values name - same naming convention as classes (for example MyNewEnum).
 
@@ -121,7 +122,7 @@ uint32_t adc_function(analogin_t *obj, uint32_t options)
 
 - Words separated by underscore (wait_ms, read_u16).
 
-As an example:
+An example:
 
 ```cPP TODO
 #define ADC_INSTANCE_SHIFT 8