Merge branch 'new_engine' into patch-1

Author: Deepika

docs.json

@@ -6,53 +6,53 @@ Your application code is written in C and C++. It uses the *application programm
 
 #### Where to start
 
-<span class="tips">If you're working on Windows, you might need to <a href="/docs/v5.6/tutorials/windows-serial-driver.html" target="_blank">install a serial driver</a>.</span>
+<span class="tips">If you're working on Windows, you might need to [install a serial driver](/docs/v5.7/tutorials/windows-serial-driver.html).
 
-The easiest way to work with Mbed OS is using one of our development tools. We've set up an example, <a href="/docs/v5.6/tutorials/your-first-arm-mbed-application.html" target="_blank">Blinky</a>, that you can try on each of the tools. Blinky teaches you to build and run an application on your board.
+The easiest way to work with Mbed OS is using one of our development tools. We've set up an example, [Blinky](/docs/v5.7/tutorials/your-first-program.html), that you can try on each of the tools. Blinky teaches you to build and run an application on your board.
 
-Once you know how to build an existing application, it's time to learn <a href="/docs/v5.6/reference/index.html" target="_blank">how to write your own applications</a>.
+Once you know how to build an existing application, it's time to learn [how to write your own applications](/docs/v5.7/reference/index.html).
 
 ##### Development tools
 
-- Our offline development tool is <a href="/docs/v5.6/tools/mbed-cli.html" target="_blank">Arm Mbed CLI</a>, a command-line tool. This requires having a toolchain installed on your computer.
-- The <a href="/docs/v5.6/tools/arm-mbed-online-compiler.html" target="_blank">Arm Mbed Online Compiler</a> lets you write and build applications using a web browser.
-- If you're working with third party tools, look at <a href="/docs/v5.6/tools/exporting.html" target="_blank">exporting instructions for the most popular ones</a>.
+- Our offline development tool is [Arm Mbed CLI](/docs/v5.7/tools/arm-mbed-cli.html), a command-line tool. This requires having a toolchain installed on your computer.
+- The [Arm Mbed Online Compiler](/docs/v5.7/tools/arm-online-compiler.html) lets you write and build applications using a web browser.
+- If you're working with third party tools, look at [exporting instructions for the most popular ones](/docs/v5.7/tools/exporting.html).
 
 ##### Communicating with and monitoring your board
 
-You can <a href="/docs/v5.6/tutorials/serial-communication-overview.html" target="_blank">monitor and control an Mbed board</a> to help you debug and test your applications.
+You can [monitor and control an Mbed board](/docs/v5.7/tutorials/serial-comm.html) to help you debug and test your applications.
 
-<span class="tips">**Tip:** Learn more about debugging in the <a href="/docs/v5.6/tutorials/debugging-applications.html" target="_blank">debugging applications section</a>.</span>
+<span class="tips">**Tip:** Learn more about debugging in the [debugging applications section](/docs/v5.7/tutorials/debugging-applications.html).</span>
 
 #### How to continue
 
 When you've started writing applications using your selected development tool:
 
-- Learn about <a href="/docs/v5.6/tools/collab-online-comp.html" target="_blank">collaborative work and version control</a>.
-- Try one of the <a href="/docs/v5.6/tutorials/index.html" target="_blank">tutorials</a>, which cover concepts such as debugging and memory tracing.
-- Ask questions and give advice on the <a href="https://os.mbed.com/forum/" target="_blank">forum</a>.
+- Learn about [collaborative work and version control](/docs/v5.7/tools/collab-online-comp.html).
+- Try one of the [tutorials](/docs/v5.7/tutorials/index.html), which cover concepts such as debugging and memory tracing.
+- Ask questions and give advice on the [forum](https://os.mbed.com/forum/).
 
 #### Contributing to Mbed OS
 
-If you want to contribute to the `mbed-os` codebase, please see <a href="/docs/v5.6/reference/contributing-overview.html" target="_blank">the contribution section</a>.
+If you want to contribute to the `mbed-os` codebase, please see [the contribution section](/docs/v5.7/reference/contributing.html).
 
-You can find past releases and the current release on <a href="https://github.com/ARMmbed/mbed-os/releases/" target="_blank">GitHub</a>.
+You can find past releases and the current release on [GitHub](https://github.com/ARMmbed/mbed-os/releases/).
 
 #### Porting to Mbed OS
 
 Our full contributing guide is still being written. For now, we have:
 
-- A guide to <a href="/docs/v5.6/reference/contributing-target.html" target="_blank">contributing targets</a>.
-- Information about the <a href="/docs/v5.6/reference/contributing-tools.html" target="_blank">tools you need to contribute targets</a>.
-- APIs about <a href="/docs/v5.6/reference/contributing-storage.html" target="_blank">storage</a> and <a href="/docs/v5.6/reference/contributing-connectivity.html" target="_blank">connectivity</a> in relation to porting.
+- A guide to [contributing targets](/docs/v5.7/reference/contributing-target.html).
+- Information about the [tools you need to contribute targets](/docs/v5.7/reference/contributing-tools.html).
+- APIs about [storage](/docs/v5.7/reference/contributing-storage.html) and [connectivity](/docs/v5.7/reference/contributing-connectivity.html) in relation to porting.
 
 ## How Mbed works
 
 The Arm Mbed hardware architecture is designed to make sure you have all the tools and utilities to be productive. Most boards have an integrated debug circuit that assists development by programming the device, logging program execution and giving access to the debug access port. Here is how it works.
 
 #### Architecture diagram
 
-This is the basic architecture of an <a href="/docs/v5.6/introduction/how-mbed-works.html" target="_blank">Mbed board</a>:
+This is the basic architecture of an Mbed board:
 
 <span class="images">![](https://s3-us-west-2.amazonaws.com/mbed-os-docs-images/mbed_internal.png)<span>A sketch of a typical Mbed board's hardware architecture</span></span>
 
@@ -73,7 +73,7 @@ The `.bin` files the Mbed microcontroller accepts are standard raw binaries. Use
 
 #### The Arm Mbed interface
 
-You can find more information about the Mbed interface and the circuits on which it runs in the <a href="/docs/v5.6/reference/contributing-tools.html#arm-mbed-hdk" target="_blank">HDK reference manual</a> or on the <a href="https://github.com/ARMmbed/DAPLink/blob/master/README.md" target="_blank">DAPLink GitHub page</a>. The HDK includes reference circuits you can use to create your own boards, and DAPLink is the firmware that runs on these circuits.
+You can find more information about the Mbed interface and the circuits on which it runs in the [HDK reference manual](/docs/v5.7/reference/contributing-tools.html#arm-mbed-hdk) or on the [DAPLink page](/docs/v5.7/tools/daplink.html). The HDK includes reference circuits you can use to create your own boards, and DAPLink is the firmware that runs on these circuits.
 
 #### Connectivity
 

docs/images/Thread_network_setup.PNG

@@ -2,49 +2,49 @@
 
 ### A
 
-**API** - [Application programming interface](/docs/v5.6/reference/api-overview.html).
+**API** - [Application programming interface](/docs/v5.7/reference/apis.html).
 
 **Application** - An executable module built out of libraries that acts as a final product.
 
-**Arm Mbed CLI** - The name of the Arm Mbed [command-line tool](/docs/v5.6/tools/mbed-cli.html), packaged as `mbed-cli`.
+**Arm Mbed CLI** - The name of the Arm Mbed [command-line tool](/docs/v5.7/tools/arm-mbed-cli.html), packaged as `mbed-cli`.
 
-**Arm Mbed interface** - The extra chip that sits on all [Mbed Enabled development boards](/docs/v5.6/introduction/how-mbed-works.html#architecture-diagram). It's what makes the target chip (for example, K64F) look like a USB drive. It usually runs a separate piece of software that generally doesn't change. That software is usually `DAPLink`, `CMSIS-DAP` or `STLink`.
+**Arm Mbed interface** - The extra chip that sits on all [Mbed Enabled development boards](/docs/v5.7/introduction/index.html). It's what makes the target chip (for example, K64F) look like a USB drive. It usually runs a separate piece of software that generally doesn't change. That software is usually `DAPLink`, `CMSIS-DAP` or `STLink`.
 
-**Arm Mbed Online Compiler** - [Arm’s online tool](/docs/v5.6/tools/arm-mbed-online-compiler.html), which you can use to create and compile your code.
+**Arm Mbed Online Compiler** - [Arm’s online tool](/docs/v5.7/tools/arm-online-compiler.html), which you can use to create and compile your code.
 
 **Arm Mbed OS** - Arm's [platform operating system](https://os.mbed.com/docs) for the Internet of Things.
 
-**Arm Mbed TLS** - A [comprehensive SSL/TLS solution](/docs/v5.6/reference/tls.html) that makes it easy for developers to include cryptographic and SSL/TLS capabilities in their software and embedded products. As an SSL library, it provides an intuitive API, readable source code and a minimal and highly configurable code footprint.
+**Arm Mbed TLS** - A [comprehensive SSL/TLS solution](/docs/v5.7/reference/tls.html) that makes it easy for developers to include cryptographic and SSL/TLS capabilities in their software and embedded products. As an SSL library, it provides an intuitive API, readable source code and a minimal and highly configurable code footprint.
 
-**Arm Mbed uVisor** - A self-contained [software hypervisor](/docs/v5.6/reference/tls.html#uVisor) that creates independent secure domains on ARM Cortex-M3 and M4 micro-controllers.
+**Arm Mbed uVisor** - A self-contained [software hypervisor](/docs/v5.7/reference/tls.html#uVisor) that creates independent secure domains on ARM Cortex-M3 and M4 micro-controllers.
 
 ### B
 
 **Bit** - A basic unit of digital information that can be one of two values: `0` (`false`) or `1` (`true`).
 
-**BLE** - [Bluetooth Low Energy](/docs/v5.6/reference/ble.html).
+**BLE** - [Bluetooth Low Energy](/docs/v5.7/reference/ble.html).
 
-**Blinky** - An [example application](/docs/v5.6/tutorials/your-first-arm-mbed-application.html) that you can use to get to know Arm Mbed OS and the development tools. It’s one of the simplest examples of Mbed OS.
+**Blinky** - An [example application](/docs/v5.7/tutorials/your-first-program.html) that you can use to get to know Arm Mbed OS and the development tools. It’s one of the simplest examples of Mbed OS.
 
-**Block Device** - A [file](/docs/v5.6/reference/contributing-storage.html#block-devices) that represents a device, with data that can be read or written to it in blocks.
+**Block Device** - A [file](/docs/v5.7/reference/contributing-storage.html#block-devices) that represents a device, with data that can be read or written to it in blocks.
 
 **Board** - An Mbed Enabled development board. You can see a [complete list](https://os.mbed.com/platforms/) of Mbed Enabled boards.
 
 **Boolean** - A binary variable, having two possible values called `true` and `false`.
 
-**Bootloader** - [The program](/docs/v5.6/tutorials/creating-and-using-a-bootloader.html) that loads Mbed OS when a board is turned on.
+**Bootloader** - [The program](/docs/v5.7/tutorials/bootloader.html) that loads Mbed OS when a board is turned on.
 
-**Build Profile** - Mbed OS 5 supports three primary [build profiles](/docs/v5.6/tools/mbed-cli.html#build-profiles): develop, debug and release.
+**Build Profile** - Mbed OS 5 supports three primary [build profiles](/docs/v5.7/tools/build-profiles.html): develop, debug and release.
 
 **Build Script** - A build automation and generation utility.
 
 **Byte** - A unit of digital information that consists of 8 bits (see `Bit`).
 
 ### C
 
-**Callback** - Any [executable code](/docs/v5.6/reference/callback.html) that is passed as an argument to other code, which is expected to call back (execute) the argument at a given time.
+**Callback** - Any [executable code](/docs/v5.7/reference/callback.html) that is passed as an argument to other code, which is expected to call back (execute) the argument at a given time.
 
-**CAN** - [Controller-area network](/docs/v5.6/reference/can.html).
+**CAN** - [Controller-area network](/docs/v5.7/reference/can.html).
 
 **Class** - An extensible program-code-template for creating objects, providing initial values for state and implementations of behavior.
 
@@ -58,29 +58,29 @@
 
 **DAPLink** - An Arm maintained [project](https://github.com/mbedmicro/DAPLink) that is under active development.
 
-**Debugging** - The [process](/docs/v5.6/tools/debugging.html) of finding and solving problems in code.
+**Debugging** - The [process](/docs/v5.7/tools/debugging.html) of finding and solving problems in code.
 
 **Deprecation** - Marking a piece of code as out of date. You should not write new code that depends on deprecated APIs. We will remove deprecated APIs when our code no longer depends on them.
 
 ### E
 
-**Exporter** - Use the Arm Mbed [exporters](/docs/v5.6/tools/exporting.html#about-the-exporters) to export your code to various third party tools and IDEs.
+**Exporter** - Use the Arm Mbed [exporters](/docs/v5.7/tools/exporting.html#about-the-exporters) to export your code to various third party tools and IDEs.
 
 ### G
 
 **GitHub** - A web-based [Git development platform](https://github.com/armmbed/mbed-os) for version-controlled repositories.
 
 **GPIO** - General-purpose input/output, a generic pin that is controllable by the user at run-time.
 
-**Greentea** - **G**eneric **re**gression **en**vironment for **te**st **a**utomation. [Greentea](/docs/v5.6/tools/tools-testing.html#greentea) is the automated testing tool for Arm Mbed OS development.
+**Greentea** - **G**eneric **re**gression **en**vironment for **te**st **a**utomation. [Greentea](/docs/v5.7/tools/greentea.html) is the automated testing tool for Arm Mbed OS development.
 
 ### H
 
 **htrun** - An Mbed OS command used to drive test binary flashing, device reset and test execution.
 
 ### I
 
-**I2C** - [Interintegrated Circuit](/docs/v5.6/reference/i2c.html) (short-distance, intraboard communication).
+**I2C** - [Interintegrated Circuit](/docs/v5.7/reference/i2c.html) (short-distance, intraboard communication).
 
 **IDE** - Integrated Development Environment.
 
@@ -118,13 +118,13 @@
 
 **REST** - Representational State Transfer (API).
 
-**RTOS** - [Real-Time Operating System](/docs/v5.6/reference/rtos-api.html).
+**RTOS** - [Real-Time Operating System](/docs/v5.7/reference/rtos.html).
 
 ### S
 
-**Serial** - A [protocol](/docs/v5.6/reference/serial.html) used in data transmission for the transfer of individual bits of information.
+**Serial** - A [protocol](/docs/v5.7/reference/serial.html) used in data transmission for the transfer of individual bits of information.
 
-**SPI** - [Serial Peripheral Interface](/docs/v5.6/reference/spi.html).
+**SPI** - [Serial Peripheral Interface](/docs/v5.7/reference/spi.html).
 
 **Static Memory** - The allocation of memory at compile time, before the program is executed.
 
@@ -134,16 +134,16 @@
 
 ### T
 
-**Target** - See [`board`](/docs/v5.6/introduction/glossary.html#board).
+**Target** - See [`board`](/docs/v5.7/introduction/glossary.html#board).
 
-**Terminal Application** - [Applications](/docs/v5.6/tutorials/serial-comm.html#using-terminal-applications) that run on your host PC that provide a window where your Mbed board can print and where you can type characters back to your board.
+**Terminal Application** - [Applications](/docs/v5.7/tutorials/serial-comm.html#using-terminal-applications) that run on your host PC that provide a window where your Mbed board can print and where you can type characters back to your board.
 
 **TLS** - Transport Layer Security.
 
-**Toolchain** - A [group of programming tools](/docs/v5.6/tools/exporting.html#setting-up-a-local-debug-toolchain).
+**Toolchain** - A [group of programming tools](/docs/v5.7/tools/exporting.html#setting-up-a-local-debug-toolchain).
 
 **Travis CI** - a continuous integration service used to build and test software projects hosted at GitHub (see `GitHub`).
 
 ### U
 
-**utest** - A [test harness](/docs/v5.6/tools/tools-testing.html#utest-asynchronous-c-test-harness) you can use to execute a specified series of (asynchronous) C++ test cases.
+**utest** - A [test harness](/docs/v5.7/tools/utest-asynchronous-c-test-harness.html) you can use to execute a specified series of (asynchronous) C++ test cases.

docs/introduction/introduction.md

@@ -1,13 +1,13 @@
 ## API overview
 
-The <a href="/docs/v5.6/introduction/glossary.html" target="_blank">APIs</a> in this document are organized by the feature, or group of features, they enable.
+The [APIs](/docs/v5.7/introduction/glossary.html) in this document are organized by the feature, or group of features, they enable.
 
-- <a href="/docs/v5.6/reference/platform.html" target="_blank">Platform</a>: platform modules that provide consistent user experience.
-- <a href="/docs/v5.6/reference/drivers.html" target="_blank">Drivers</a>: analog and digital input and outputs and digital interfaces.
-- <a href="/docs/v5.6/reference/rtos.html" target="_blank">RTOS</a>: handling tasks and events in Mbed OS.
-- <a href="/docs/v5.6/reference/network-socket.html" target="_blank">Network Socket</a>: network sockets, Ethernet, Wi-Fi, cellular and mesh networking.
-- <a href="/docs/v5.6/reference/bluetooth.html" target="_blank">Bluetooth</a>: bluetooth low energy.
-- <a href="/docs/v5.6/reference/security.html" target="_blank">Security</a>: working with Arm Mbed uVisor and Arm Mbed TLS in the context of Mbed OS.
-- <a href="/docs/v5.6/reference/storage.htmll" target="_blank">Storage</a>: working with the file system.
+- [Platform](/docs/v5.7/reference/platform.html): platform modules that provide consistent user experience.
+- [Drivers](/docs/v5.7/reference/drivers.html): analog and digital input and outputs and digital interfaces.
+- [RTOS](/docs/v5.7/reference/rtos.html): handling tasks and events in Mbed OS.
+- [Network Socket](/docs/v5.7/reference/network-socket.html): network sockets, Ethernet, Wi-Fi, cellular and mesh networking.
+- [Bluetooth](/docs/v5.7/reference/bluetooth.html): bluetooth low energy.
+- [Security](/docs/v5.7/reference/security.html): working with Arm Mbed uVisor and Arm Mbed TLS in the context of Mbed OS.
+- [Storage](/docs/v5.7/reference/storage.html): working with the file system.
 
-We also provide guidelines for <a href="/docs/v5.6/reference/contributing.html" target="_blank">contributing to Mbed OS</a>.
+We also provide guidelines for [contributing to Mbed OS](/docs/v5.7/reference/contributing.html).

docs/introduction/terms.md

@@ -2,11 +2,11 @@
 
 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 <a href="https://os.mbed.com/platforms/?mbed-enabled=15&connectivity=3" target="_blank">targets and components</a> support Mbed BLE. Developers can use it to create new BLE enabled applications.
+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.
 
 ### BLE class reference
 
-[![View code](https://www.mbed.com/embed/?type=library)](https://os.mbed.com/docs/v5.6/mbed-os-api-doxy/class_b_l_e.html)
+[![View code](https://www.mbed.com/embed/?type=library)](http://os-doc-builder.test.mbed.com/docs/v5.7/mbed-os-api-doxy/class_b_l_e.html)
 
 ### Usage
 
@@ -30,4 +30,4 @@ Here is an example demonstrating how to build a heart rate sensor that can be co
 
 ### Related content
 
-- Mbed Enabled <a href="https://os.mbed.com/platforms/?mbed-enabled=15&connectivity=3" target="_blank">targets and components</a> that support BLE.
+- Mbed Enabled [targets and components](https://os.mbed.com/platforms/?mbed-enabled=15&connectivity=3) that support BLE.