Final change to connectivity

iriark01 · iriark01 · commit e5fa889b3f26 · 2020-05-13T19:50:05.000+01:00
diff --git a/docs.json b/docs.json
@@ -701,10 +701,10 @@
                         },
                         {
                             "title": "Connectivity architecture",
-                            "intro": {
+                            "sources": [{
                                 "path": "docs/api/networking-arch.md"
                             },
-                            "sources": [{
+                            {
                                     "path": "docs/api/networksocket/networksocket.md"
                                 },
                                 {
@@ -793,18 +793,10 @@
                                 {
                                     "path": "docs/api/networkinterfaces/MeshInterface.md"
                                 },
-                                {
-                                    "path": "docs/api/nfc/MessageBuilder.md"
-                                },
-                                {
-                                    "path": "docs/api/nfc/MessageParser.md"
-                                },
                                 {
                                     "path": "docs/api/networkinterfaces/NetworkStatus.md"
                                 },
-                                {
-                                    "path": "docs/api/nfc/SimpleMessageParser.md"
-                                },
+
                                 {
                                     "path": "docs/api/networkinterfaces/WifiInterface.md"
                                 }
@@ -854,14 +846,20 @@
                         },
                         {
                             "title": "NFC APIs",
-                            "intro": {
-                                "path": "docs/api/nfc/NDEF.md"
-                            },
                             "sources": [{
+                                "path": "docs/api/nfc/MessageBuilder.md"
+                            },
+                            {
+                                "path": "docs/api/nfc/MessageParser.md"
+                            },
+                            {
                                     "path": "docs/api/nfc/NFCController.md"
                                 },
                                 {
                                     "path": "docs/api/nfc/NFCEEPROM.md"
+                                },
+                                {
+                                    "path": "docs/api/nfc/SimpleMessageParser.md"
                                 }
                             ]
                         },
diff --git a/docs/api/api.md b/docs/api/api.md
@@ -219,10 +219,7 @@ This list does not include the internal APIs, which are not intended for use by
 | [Cellular](../apis/cellular-api.html) | &#10004; | |
 | [Ethernet](../apis/ethernet.html) | &#10004; | |
 | [Mesh](../apis/mesh-api.htm) | &#10004; | |
-| [MessageBuilder](../apis/messagebuilder.html) | &#10004; | |
-| [MessageParser](../apis/messageparser.html) | &#10004; | |
 | [Network status](../apis/network-status.html) | &#10004; | |
-| [SimpleMessageParser](../apis/simplemessageparser.html) | &#10004; | |
 | [Wi-Fi](../apis/wi-fi.html) | &#10004; | |
 
 ### Secure socket
@@ -258,8 +255,11 @@ This list does not include the internal APIs, which are not intended for use by
 
 | API | Full profile | Bare metal profile |
 | - | - | - |
+| [MessageBuilder](../apis/messagebuilder.html) | &#10004; | |
+| [MessageParser](../apis/messageparser.html) | &#10004; | |
 | [NFCController](../apis/nfccontroller.html) | &#10004; |&#10004; (can be manually enabled) |
 | [NFC EEPROM](../apis/nfc-eeprom.html) | &#10004; | &#10004; (can be manually enabled) |
+| [SimpleMessageParser](../apis/simplemessageparser.html) | &#10004; | |
 
 ### LoRaWAN
 
diff --git a/docs/api/bluetooth/ble_tutorial.md b/docs/api/bluetooth/ble_tutorial.md
@@ -1,4 +1,4 @@
-<h1 id="ble-tutorial">BLE</h1>
+# BLE tutorials
 
 ## Getting started
 
diff --git a/docs/api/connectivity_list.md b/docs/api/connectivity_list.md
@@ -14,10 +14,7 @@
 - [Cellular](../apis/cellular-api.html): Connect to the internet over a Cellular device.
 - [Ethernet](../apis/ethernet.html): Connect to the internet over Ethernet.
 - [Mesh](../apis/mesh-api.htm): Use the IPv6 mesh network topologies through the Nanostack networking stack to connect to a mesh network: Wi-Sun or 6LoWPAN-ND.
-- [MessageBuilder](../apis/messagebuilder.html): Construct NDEF messages, the common data format exchange for NFC messages.
-- [MessageParser](../apis/messageparser.html): An event-driven NDEF message parser for a data buffer.
 - [Network status](../apis/network-status.html): Trigger a callback each time the network interface's status changes.
-- [SimpleMessageParser](../apis/simplemessageparser.html): Similar to MessageParser, but includes subparsers for well-known NFC types records, such as Text, URI or Mime records, and produces usable objects out of the box.
 - [Wi-Fi](../apis/wi-fi.html): Connect to the internet over a Wi-Fi device.
 
 ## Secure socket
@@ -41,10 +38,11 @@
 
 ## NFC
 
+- [MessageBuilder](../apis/messagebuilder.html): Construct NDEF messages, the common data format exchange for NFC messages.
+- [MessageParser](../apis/messageparser.html): An event-driven NDEF message parser for a data buffer.
 - [NFCController](../apis/nfccontroller.html): Emulate NFC tags that a smartphone can read and generate NDEF messages on demand.
 - [NFC EEPROM](../apis/nfc-eeprom.html): Store NDEF messages.
-
-Note: Use MessageParser SimpleMessageParser and MessageBuilder to construct and parse NDEF messages.
+- [SimpleMessageParser](../apis/simplemessageparser.html): Similar to MessageParser, but includes subparsers for well-known NFC types records, such as Text, URI or Mime records, and produces usable objects out of the box.
 
 ## LoRaWAN
 
diff --git a/docs/api/lorawan/lorawanintro.md b/docs/api/lorawan/lorawanintro.md
@@ -1,4 +1,4 @@
-# LoRaWAN overview
+# LoRaWAN usage
 
 LoRaWAN is a technology designed for low-power battery powered devices. These devices operate in an unlicensed spectrum, creating high density wide-area networks.
 
diff --git a/docs/api/networkinterfaces/networkinterface.md b/docs/api/networkinterfaces/networkinterface.md
@@ -1,4 +1,4 @@
-# Network interface overview
+# Network interface
 
 A socket requires a NetworkInterface instance to indicate which NetworkInterface the socket should be created on. The NetworkInterface provides a network stack that implements the underlying socket operations.
 
@@ -118,7 +118,7 @@ Please see the previous section, [Default network interface](#default-network-in
 
 For network status changes, the API is specified in [Network status](network-status.html) section. Being portable means that your application only communicates after `NSAPI_STATUS_GLOBAL_UP` is received and tries to reconnect the network if `NSAPI_STATUS_DISCONNECTED` is received without calling `NetworkInterface::disconnect()`.
 
-# Using multiple network interfaces
+## Using multiple network interfaces
 
 In Mbed OS, applications usually use one network interface at a time, and most APIs are designed this way. With few limitations, applications are able to operate more than one NetworkInterface. In Mbed OS, there are two built-in IP stacks and many external IP stacks provided by modules. Please refer to the [Architecture:IP networking](../reference/ip-networking.html) section for an explanation of how different stacks are integrated into Mbed OS.
 
diff --git a/docs/api/networksocket/networksocket.md b/docs/api/networksocket/networksocket.md
@@ -1,4 +1,4 @@
-<h1 id="network-socket">Network socket overview</h1>
+# Network socket
 
 The application programming interface for IP networking is the Socket API. As described in the [IP networking](../reference/ip-networking.html) section, the Socket API relates to OSI layer 4, the Transport layer. In Mbed OS, the Socket API is abstract and supports various protocols such as TCP, UDP and non-IP data delivery for NB-IoT cellular networks.
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1 id="ble-tutorial">BLE</h1>`
	`1`	`+# BLE tutorials`
`2`	`2`
`3`	`3`	`## Getting started`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# LoRaWAN overview`
	`1`	`+# LoRaWAN usage`
`2`	`2`
`3`	`3`	`LoRaWAN is a technology designed for low-power battery powered devices. These devices operate in an unlicensed spectrum, creating high density wide-area networks.`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-<h1 id="network-socket">Network socket overview</h1>`
	`1`	`+# Network socket`
`2`	`2`
`3`	`3`	`The application programming interface for IP networking is the Socket API. As described in the [IP networking](../reference/ip-networking.html) section, the Socket API relates to OSI layer 4, the Transport layer. In Mbed OS, the Socket API is abstract and supports various protocols such as TCP, UDP and non-IP data delivery for NB-IoT cellular networks.`
`4`	`4`