Merge branch 'bugfix/btdm_tutorials_compatible_with_github' into 'master'

component/bt: modify ble tutorials to make them be compatible with GitHub markdown

See merge request idf/esp-idf!1786

docs/api-reference/bluetooth/esp_gap_ble.rst

@@ -11,9 +11,17 @@ Overview
 Application Example
 -------------------
 
-Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following applications:
+Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following demos and their tutorials:
 
-* The two demos use different GAP APIs, such like advertising, scan, set device name and others - :example:`bluetooth/gatt_server`, :example:`bluetooth/gatt_client`
+* This is a SMP security client demo and its tutorial. This demo initiates its security parameters and acts as a GATT client, which can send a security request to the peer device and then complete the encryption procedure.
+
+    - :example:`bluetooth/gatt_security_client`  
+    - :example_file:`GATT Security Client Example Walkthrough <bluetooth/gatt_security_client/tutorial/Gatt_Security_Client_Example_Walkthrough.md>`
+
+* This is a SMP security server demo and its tutorial. This demo initiates its security parameters and acts as a GATT server, which can send a pair request to the peer device and then complete the encryption procedure. 
+
+    - :example:`bluetooth/gatt_security_server`
+    - :example_file:`GATT Security Server Example Walkthrough <bluetooth/gatt_security_server/tutorial/Gatt_Security_Server_Example_Walkthrough.md>`
 
 API Reference
 -------------

docs/api-reference/bluetooth/esp_gattc.rst

@@ -11,9 +11,21 @@ Overview
 Application Example
 -------------------
 
-Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following application:
+Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following demos and their tutorials:
 
-* This is a GATT client demo. This demo can scan devices, connect to the GATT server and discover the service :example:`bluetooth/gatt_client`
+* This is a GATT client demo and its tutorial. This demo can scan for devices, connect to the GATT server and discover its services. 
+
+    - :example:`bluetooth/gatt_client`
+    - :example_file:`GATT Client Example Walkthrough <bluetooth/gatt_client/tutorial/Gatt_Client_Example_Walkthrough.md>`
+
+* This is a multiple connection demo and its tutorial. This demo can connect to multiple GATT server devices and discover their services. 
+
+    - :example:`bluetooth/gattc_multi_connect`
+    - :example_file:`GATT Client Multi-connection Example Walkthrough <bluetooth/gattc_multi_connect/tutorial/Gatt_Client_Multi_Connection_Example_Walkthrough.md>`
+
+* This is a BLE SPP-Like demo. This demo, which acts as a GATT client, can receive data from UART and then send the data to the peer device automatically.
+
+    - :example:`bluetooth/ble_spp_client` 
 
 API Reference
 -------------

docs/api-reference/bluetooth/esp_gatts.rst

@@ -11,9 +11,21 @@ Overview
 Application Example
 -------------------
 
-Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following application:
+Check :example:`bluetooth` folder in ESP-IDF examples, which contains the following demos and their tutorials:
 
-* This is a GATT server demo. Use GATT API to create a GATT server with send advertising. This GATT server can be connected and the service can be discovery - :example:`bluetooth/gatt_server`
+* This is a GATT sever demo and its tutorial. This demo creates a GATT service with an attribute table, which releases the user from adding attributes one by one. This is the recommended method of adding attributes. 
+
+    - :example:`bluetooth/gatt_server_service_table`
+    - :example_file:`GATT Server Service Table Example Walkthrough <bluetooth/gatt_server_service_table/tutorial/Gatt_Server_Service_Table_Example_Walkthrough.md>`
+
+* This is a GATT server demo and its tutorial. This demo creates a GATT service by adding attributes one by one as defined by Bluedroid. The recommended method of adding attributes is presented in example above.
+
+    - :example:`bluetooth/gatt_server`
+    - :example_file:`GATT Server Example Walkthrough <bluetooth/gatt_server/tutorial/Gatt_Server_Example_Walkthrough.md>`
+
+* This is a BLE SPP-Like demo. This demo, which acts as a GATT server, can receive data from UART and then send the data to the peer device automatically.
+
+    - :example:`bluetooth/ble_spp_server`
 
 API Reference
 -------------

docs/api-reference/bluetooth/index.rst

@@ -10,4 +10,18 @@ Bluetooth API
    Bluetooth Classic <classic_bt>
 
 
+To see the overview of the ESP32 Bluetooth stack architecture, follow links below:
+
+* `ESP32 Bluetooth Architecture (PDF) [English] <http://espressif.com/sites/default/files/documentation/esp32_bluetooth_architecture_en.pdf>`_
+* `ESP32 Bluetooth Architecture (PDF) [中文] <http://espressif.com/sites/default/files/documentation/esp32_bluetooth_architecture_cn.pdf>`_
+
 Example code for this API section is provided in :example:`bluetooth` directory of ESP-IDF examples.
+
+Several examples contain detailed description. To see them please follow links below:
+
+* :example_file:`GATT Client Example Walkthrough <bluetooth/gatt_client/tutorial/Gatt_Client_Example_Walkthrough.md>`
+* :example_file:`GATT Server Service Table Example Walkthrough <bluetooth/gatt_server_service_table/tutorial/Gatt_Server_Service_Table_Example_Walkthrough.md>`
+* :example_file:`GATT Server Example Walkthrough <bluetooth/gatt_server/tutorial/Gatt_Server_Example_Walkthrough.md>`
+* :example_file:`GATT Security Client Example Walkthrough <bluetooth/gatt_security_client/tutorial/Gatt_Security_Client_Example_Walkthrough.md>`
+* :example_file:`GATT Security Server Example Walkthrough <bluetooth/gatt_security_server/tutorial/Gatt_Security_Server_Example_Walkthrough.md>`
+* :example_file:`GATT Client Multi-connection Example Walkthrough <bluetooth/gattc_multi_connect/tutorial/Gatt_Client_Multi_Connection_Example_Walkthrough.md>`