API deprecation notices

Author: iriark01

docs/api/bluetooth/BLE.md

@@ -1,5 +1,7 @@
 # BLE
 
+<span class="notes">**Note:** Some functions, variables or types have been deprecated. Please see the class reference linked below for details.</span>
+
 Bluetooth low energy (BLE) is a low power wireless technology standard for building personal area networks. Typical applications of BLE are health care, fitness trackers, beacons, smart home, security, entertainment, proximity sensors, industrial and automotive.
 
 Arm Mbed BLE, also called `BLE_API`, is the Bluetooth Low Energy software solution for Mbed. Many Mbed [targets and components](https://os.mbed.com/platforms/?mbed-enabled=15&connectivity=3) support Mbed BLE. Developers can use it to create new BLE enabled applications.

docs/api/bluetooth/Gap.md

@@ -1,5 +1,7 @@
 # GAP
 
+<span class="notes">**Note:** Some functions, variables or types have been deprecated. Please see the class reference linked below for details.</span>
+
 <span class="images">![](https://os.mbed.com/docs/mbed-os/development/mbed-os-api-doxy/class_gap.png)<span>Gap class hierarchy</span></span>
 
 The Generic Access Profile is the layer of the stack that handles connectivity tasks. This includes link establishment and termination, advertising and scanning.
@@ -62,7 +64,7 @@ There are two separate MTUs to consider: the `ATT_MTU` (maximum attribute size)
 
 The default value of data length supported by all controllers is 23 octets. If both controllers support data length extension and a higher value is negotiated, the BLE stack will call `onDataLengthChange` in the `Gap::EventHandler` registered by the user.
 
-`ATT_MTU` and data length are independent of each other. 
+`ATT_MTU` and data length are independent of each other.
 
 ## GAP class reference
 

docs/api/bluetooth/GattClient.md

@@ -1,5 +1,7 @@
 # GattClient
 
+<span class="notes">**Note:** Some functions, variables or types have been deprecated. Please see the class reference linked below for details.</span>
+
 You can use Generic Attribute Profile (GATT) to discover services, characteristics and descriptors and to perform operations on them. The interaction happens between two peers, one of which is the client (which initiates interactions) and the other is the server (which responds). You can use Attribute Protocol (ATT) to implement this interaction. `GattClient` defines procedures required for interacting with a remote `GattServer`.
 
 ## Discovery procedures

docs/api/bluetooth/GattServer.md

@@ -1,5 +1,7 @@
 # GattServer
 
+<span class="notes">**Note:** Some functions, variables or types have been deprecated. Please see the class reference linked below for details.</span>
+
 You can use Generic Attribute Profile (GATT) to discover services, characteristics and descriptors and to perform operations on them. The interaction happens between two peers, one of which is the client (which initiates interactions) and the other is the server (which responds). You can use Attribute Protocol (ATT) to implement this interaction.
 
 `GattServer` is a collection of GattServices. These services contain characteristics that a `GattClient` on the peer connected to the device may read or write. These characteristics may also emit updates to subscribed clients when their values change.

docs/api/bluetooth/UARTService.md

@@ -1,6 +1,6 @@
 # UARTService
 
-[Add description here.]
+<span class="notes">**Note:** This service has been deprecated.</span>
 
 ## UARTService class reference
 

docs/api/bluetooth/iBeacon.md

@@ -1,5 +1,7 @@
 # iBeacon
 
+<span class="notes">**Note:** This class has been deprecated.</span>
+
 iBeacon is an Apple technology based on BLE that you can use as an indoor positioning system. It allows iOS apps to track if the user enters a specific region and offers actions and notification aware of the user context.
 
 The iBeacon class builds an advertising payload mimicking an iBeacon and assigns it to a given BLE interface.