Merge pull request #1447 from ARMmbed/std-pin-names

Std pin names

Author: Donatien Garnier

docs.json

@@ -266,7 +266,7 @@
                             ]
                         },
                         {
-                            "title": "Standard Pin Names Developer Guide",
+                            "title": "Standard Pin Names",
                             "sources": [{
                                     "path": "docs/porting/standard_pin_names/pin_names_dev_guide.md"
                                 },

docs/porting/standard_pin_names/pin_names_dev_guide.md

@@ -1,15 +1,11 @@
-## Introduction
-
-### Overview and assumptions
+## Standard Pin Names
 
-Platform code should be portable across different Mbed supported boards with the same hardware capabilities or interfaces.
+In general, platform code should be portable across different Mbed supported boards with the same hardware capabilities or interfaces.
 
 This document provides general developer guidelines on pin names that apply to all boards but it's not specific to any type of connector.
 
 **_NOTE:_** there might be separate documents for pin names that apply to specific connectors.
 
-## Standard Pin Names
-
 ### LEDs
 
 Available onboard LEDs are defined as `LEDx` e.g. `LED1`, `LED2`, ...

docs/porting/standard_pin_names/pin_names_dev_guide_arduino.md

@@ -1,4 +1,4 @@
-## Arduino Uno 
+## Arduino Uno Pin Names
 
 The Arduino Uno connector is a standardised connector in Mbed, which has a set amount of exposed functionality. To achieve meaningful portability of application code across various Mbed boards that are Arduino Uno compliant, the pin names used for the connector pins are common across these boards.
 
@@ -62,4 +62,4 @@ For more details about UART, please check the Mbed API.
 
 **PWM/Timer pins**    
 
-In the Arduino Uno standard, there are only 6 PWM and timers available on pins ARDUINO_UNO_D3, ARDUINO_UNO_D5, ARDUINO_UNO_D6, ARDUINO_UNO_D9, ARDUINO_UNO_D10 and ARDUINO_UNO_D11. However, Mbed boards may support the usage of PWM and timers functions on other pins as well.
+In the Arduino Uno standard, there are only 6 PWM and timers available on pins ARDUINO_UNO_D3, ARDUINO_UNO_D5, ARDUINO_UNO_D6, ARDUINO_UNO_D9, ARDUINO_UNO_D10 and ARDUINO_UNO_D11. However, Mbed boards may support the usage of PWM and timers functions on other pins as well.

docs/porting/standard_pin_names/pin_names_porting.md

@@ -1,6 +1,6 @@
-# Standard Pin Names Porting Guide
+# Standard Pin Names
 
-This guide aims to help vendors to comply with the new pin naming guidelines.
+This porting guide aims to help vendors to comply with the new pin naming guidelines.
 
 There is a set of generic guidelines that apply to all boards, and further sets of guidelines that additionally apply to boards that have certain compatible connectors.
 
@@ -340,4 +340,4 @@ mbedgt: test case report:
 | DISCO_L475VG_IOT01A-GCC_ARM | DISCO_L475VG_IOT01A | hal-tests-tests-pin_names-arduino_uno | UART      | 1      | 0      | OK     | 0.07               |
 mbedgt: test case results: 37 OK
 mbedgt: completed in 34.33 sec
-```
+```