ARMmbed · deepikabhavnani · Sep 23, 2017 · Sep 23, 2017 · Sep 23, 2017 · Sep 23, 2017
diff --git a/docs.json b/docs.json
diff --git a/docs/images/6lh.png b/docs/images/6lh.png
diff --git a/docs/images/6lowpan_network_architecture.png b/docs/images/6lowpan_network_architecture.png
diff --git a/docs/images/6lowpan_stack_architecture.png b/docs/images/6lowpan_stack_architecture.png
diff --git a/docs/images/6lowpan_stack_networking_topologies.png b/docs/images/6lowpan_stack_networking_topologies.png
diff --git a/docs/images/6lowpan_stack_osi_model.png b/docs/images/6lowpan_stack_osi_model.png
diff --git a/docs/images/6lr.png b/docs/images/6lr.png
diff --git a/docs/images/Cell_AT.png b/docs/images/Cell_AT.png
diff --git a/docs/images/Cell_PPP.png b/docs/images/Cell_PPP.png
diff --git a/docs/images/DeviceOnMac.png b/docs/images/DeviceOnMac.png
diff --git a/docs/images/DeviceOnWindows.png b/docs/images/DeviceOnWindows.png
diff --git a/docs/images/Mutex.png b/docs/images/Mutex.png
diff --git a/docs/images/NUCLEOF401RE.png b/docs/images/NUCLEOF401RE.png
diff --git a/docs/images/NanostackRfPhy.png b/docs/images/NanostackRfPhy.png
diff --git a/docs/images/Semaphore.png b/docs/images/Semaphore.png
diff --git a/docs/images/accept_pull_request.png b/docs/images/accept_pull_request.png
diff --git a/docs/images/add_board.png b/docs/images/add_board.png
diff --git a/docs/images/all_programs.png b/docs/images/all_programs.png
diff --git a/docs/images/basic_collab.png b/docs/images/basic_collab.png
diff --git a/docs/images/br.png b/docs/images/br.png
diff --git a/docs/images/browser-panel.png b/docs/images/browser-panel.png
diff --git a/docs/images/bw.png b/docs/images/bw.png
diff --git a/docs/images/cellular_block_dia.png b/docs/images/cellular_block_dia.png
diff --git a/docs/images/changes_to_merge.png b/docs/images/changes_to_merge.png
diff --git a/docs/images/commit_merge.png b/docs/images/commit_merge.png
diff --git a/docs/images/compare_repo.png b/docs/images/compare_repo.png
diff --git a/docs/images/compare_revisions.png b/docs/images/compare_revisions.png
diff --git a/docs/images/comparing_repos.png b/docs/images/comparing_repos.png
diff --git a/docs/images/compile-output.png b/docs/images/compile-output.png
diff --git a/docs/images/compile.png b/docs/images/compile.png
diff --git a/docs/images/compileandinstall.png b/docs/images/compileandinstall.png
diff --git a/docs/images/compiling.png b/docs/images/compiling.png
diff --git a/docs/images/conflict_files.png b/docs/images/conflict_files.png
diff --git a/docs/images/conflict_review.png b/docs/images/conflict_review.png
diff --git a/docs/images/create-program.png b/docs/images/create-program.png
diff --git a/docs/images/create_pull_request.png b/docs/images/create_pull_request.png
diff --git a/docs/images/device_on_mac.png b/docs/images/device_on_mac.png
diff --git a/docs/images/docs_example.png b/docs/images/docs_example.png
diff --git a/docs/images/docs_in_library_1.png b/docs/images/docs_in_library_1.png
diff --git a/docs/images/docs_in_library_2.png b/docs/images/docs_in_library_2.png
diff --git a/docs/images/docs_preview1.png b/docs/images/docs_preview1.png
diff --git a/docs/images/docs_preview2.png b/docs/images/docs_preview2.png
diff --git a/docs/images/docs_update.png b/docs/images/docs_update.png
diff --git a/docs/images/eclipse1.png b/docs/images/eclipse1.png
diff --git a/docs/images/eclipse2.png b/docs/images/eclipse2.png
diff --git a/docs/images/eclipse3.png b/docs/images/eclipse3.png
diff --git a/docs/images/eclipse4.png b/docs/images/eclipse4.png
diff --git a/docs/images/eclipse5.png b/docs/images/eclipse5.png
diff --git a/docs/images/eclipse6.png b/docs/images/eclipse6.png
diff --git a/docs/images/eclipse7.png b/docs/images/eclipse7.png
diff --git a/docs/images/eclipse8.png b/docs/images/eclipse8.png
diff --git a/docs/images/eclipse9.png b/docs/images/eclipse9.png
diff --git a/docs/images/ed_scan_process.png b/docs/images/ed_scan_process.png
diff --git a/docs/images/editor-overview.png b/docs/images/editor-overview.png
diff --git a/docs/images/eventflags_usage.png b/docs/images/eventflags_usage.png
diff --git a/docs/images/examples.png b/docs/images/examples.png
diff --git a/docs/images/export_menu.png b/docs/images/export_menu.png
diff --git a/docs/images/fork.png b/docs/images/fork.png
diff --git a/docs/images/fork_indication.png b/docs/images/fork_indication.png
diff --git a/docs/images/fpu_iar.png b/docs/images/fpu_iar.png
diff --git a/docs/images/green_revisions.png b/docs/images/green_revisions.png
diff --git a/docs/images/import-mbed-os.png b/docs/images/import-mbed-os.png
diff --git a/docs/images/import_button_comp.png b/docs/images/import_button_comp.png
diff --git a/docs/images/import_button_site.png b/docs/images/import_button_site.png
diff --git a/docs/images/import_dialog.png b/docs/images/import_dialog.png
diff --git a/docs/images/import_mbed.png b/docs/images/import_mbed.png
diff --git a/docs/images/import_popup.png b/docs/images/import_popup.png
diff --git a/docs/images/import_pull_request.png b/docs/images/import_pull_request.png
diff --git a/docs/images/incoming_revisions.png b/docs/images/incoming_revisions.png
diff --git a/docs/images/inherit_from_generic_modem.png b/docs/images/inherit_from_generic_modem.png
diff --git a/docs/images/join_process_star_6lowpan_router.png b/docs/images/join_process_star_6lowpan_router.png
diff --git a/docs/images/join_process_to_router_mesh_6lowpan.png b/docs/images/join_process_to_router_mesh_6lowpan.png
diff --git a/docs/images/lights1.gif b/docs/images/lights1.gif
diff --git a/docs/images/lights1.png b/docs/images/lights1.png
diff --git a/docs/images/lights2.gif b/docs/images/lights2.gif
diff --git a/docs/images/lights2.png b/docs/images/lights2.png
diff --git a/docs/images/lights3.gif b/docs/images/lights3.gif
diff --git a/docs/images/lights3.png b/docs/images/lights3.png
diff --git a/docs/images/mail_queue.png b/docs/images/mail_queue.png
diff --git a/docs/images/main-toolbar.png b/docs/images/main-toolbar.png
diff --git a/docs/images/main_cpp.png b/docs/images/main_cpp.png
diff --git a/docs/images/maincpp.png b/docs/images/maincpp.png
diff --git a/docs/images/mbed OS 5 protection.xml b/docs/images/mbed OS 5 protection.xml
@@ -0,0 +1 @@
+<mxfile userAgent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4" version="6.8.9" editor="www.draw.io" type="device"><diagram id="d7a15faf-bf4b-0056-54cb-1d26b8fdf24f" name="Page-1">zZZbc6IwFIB/De+QIOCjS2m7D1VH2NnnCAfINBAnxqL76zdAVGjoXqY81AcnfCeXk+9kAhYOq/OTIIfyhWfALGRnZws/WAj5vqv+W3DpwQJrUAia9ci5g5j+Ag1tTU80g+Ooo+ScSXoYw5TXNaRyxIgQvBl3yzkbr3ogBRggTgkz6U+aybKnAfLv/BloUV5XdrxlH9mT9LUQ/FTr9SyE8+7XhytynUtv9FiSjDcDhCMLh4Jz2beqcwisVXvV1o97/CB6y1tALf9lwKIf8EbYCa4Zd3nJy9VFtxto+9sW/taUVEJ8IGkbbVTxFStlxdSTo5rm+jqlNxASzgOk83kCXoEUF9VFR5dajT46KNDPzb0QrqdZOSgC8jUkuvjFbeq7ANXQDqZ9YMNH8ryLVqphx6vHyJCjRqszCX8X0+6fqgO2YrSoFZO87ZBTxkLOuOhmw9kCgsxV/CgFf4VBJEB77HnzCHacsWHsuqZhNGHYCWYw7BqGv6+TaLf7sU1ml1zRLGsnMTwTCPJ0yrOXBrDP5/GMFu88B0vDM8ITnpczaPYNzetNK3i72yRRmEQPhmW1KznWObZT8/q9So2I1p0qVyD+VIep+s1g2nXcsWnbvDMc25s40TOYDgzT4eZlu1lH6yT+MpJzXstYpzHxkvj0HXI768M7ZOqS/n/h6vH+Puxig28OHP0G</diagram></mxfile>
diff --git a/docs/images/mbed-OS-5-protection.png b/docs/images/mbed-OS-5-protection.png
diff --git a/docs/images/mbedOS_sockets.png b/docs/images/mbedOS_sockets.png
diff --git a/docs/images/mbed_internal.png b/docs/images/mbed_internal.png
diff --git a/docs/images/mbed_internals.PNG b/docs/images/mbed_internals.PNG
diff --git a/docs/images/mbed_internals.jpg b/docs/images/mbed_internals.jpg
diff --git a/docs/images/mesh.png b/docs/images/mesh.png
diff --git a/docs/images/mult_authors.png b/docs/images/mult_authors.png
diff --git a/docs/images/multi_revision_history.png b/docs/images/multi_revision_history.png
diff --git a/docs/images/nanostack_in_mbed_OS.png b/docs/images/nanostack_in_mbed_OS.png
diff --git a/docs/images/network_bootstrap_high_level_view.png b/docs/images/network_bootstrap_high_level_view.png
diff --git a/docs/images/new.png b/docs/images/new.png
diff --git a/docs/images/new_file.png b/docs/images/new_file.png
diff --git a/docs/images/new_library.png b/docs/images/new_library.png
diff --git a/docs/images/new_program.png b/docs/images/new_program.png
diff --git a/docs/images/node_to_server.png b/docs/images/node_to_server.png
diff --git a/docs/images/open_pull_requests.png b/docs/images/open_pull_requests.png
diff --git a/docs/images/other_ides1.png b/docs/images/other_ides1.png
diff --git a/docs/images/pin_out.png b/docs/images/pin_out.png
diff --git a/docs/images/placeholder.md.txt b/docs/images/placeholder.md.txt
diff --git a/docs/images/printf1.png b/docs/images/printf1.png
diff --git a/docs/images/printf2.png b/docs/images/printf2.png
diff --git a/docs/images/printf3.png b/docs/images/printf3.png
diff --git a/docs/images/printf4.png b/docs/images/printf4.png
diff --git a/docs/images/printf5.png b/docs/images/printf5.png
diff --git a/docs/images/privacy_settings.png b/docs/images/privacy_settings.png
diff --git a/docs/images/publish.png b/docs/images/publish.png
diff --git a/docs/images/publish_deatils.png b/docs/images/publish_deatils.png
diff --git a/docs/images/publish_prompt.png b/docs/images/publish_prompt.png
diff --git a/docs/images/published_repo.png b/docs/images/published_repo.png
diff --git a/docs/images/pull_request_accepted.png b/docs/images/pull_request_accepted.png
diff --git a/docs/images/pull_request_closed.png b/docs/images/pull_request_closed.png
diff --git a/docs/images/pull_request_created.png b/docs/images/pull_request_created.png
diff --git a/docs/images/queue.png b/docs/images/queue.png
diff --git a/docs/images/reject_pull_request.png b/docs/images/reject_pull_request.png
diff --git a/docs/images/repo_details.png b/docs/images/repo_details.png
diff --git a/docs/images/repo_url.png b/docs/images/repo_url.png
diff --git a/docs/images/repo_url_compare.png b/docs/images/repo_url_compare.png
diff --git a/docs/images/review_pull_request.png b/docs/images/review_pull_request.png
diff --git a/docs/images/revision_history_overview.png b/docs/images/revision_history_overview.png
diff --git a/docs/images/revision_history_pull_request.png b/docs/images/revision_history_pull_request.png
diff --git a/docs/images/rpl_layer_reg_multiple_hops.png b/docs/images/rpl_layer_reg_multiple_hops.png
diff --git a/docs/images/rpl_layer_reg_single_hop.png b/docs/images/rpl_layer_reg_single_hop.png
diff --git a/docs/images/rpl_mesh_high_level_view.png b/docs/images/rpl_mesh_high_level_view.png
diff --git a/docs/images/rtos_timer.png b/docs/images/rtos_timer.png
diff --git a/docs/images/select_board.png b/docs/images/select_board.png
diff --git a/docs/images/select_target.png b/docs/images/select_target.png
diff --git a/docs/images/select_toolchain.png b/docs/images/select_toolchain.png
diff --git a/docs/images/show_board.png b/docs/images/show_board.png
diff --git a/docs/images/single_channel.png b/docs/images/single_channel.png
diff --git a/docs/images/star_topology.png b/docs/images/star_topology.png
diff --git a/docs/images/state_machine_6lowpan.png b/docs/images/state_machine_6lowpan.png
diff --git a/docs/images/thread_arch.png b/docs/images/thread_arch.png
diff --git a/docs/images/thread_priority.png b/docs/images/thread_priority.png
diff --git a/docs/images/thread_status.png b/docs/images/thread_status.png
diff --git a/docs/images/two_channels.png b/docs/images/two_channels.png
diff --git a/docs/images/tx_process.png b/docs/images/tx_process.png
diff --git a/docs/images/uVision.png b/docs/images/uVision.png
diff --git a/docs/images/update_from.png b/docs/images/update_from.png
diff --git a/docs/images/updates.png b/docs/images/updates.png
diff --git a/docs/images/uvision1.png b/docs/images/uvision1.png
diff --git a/docs/images/uvision2.png b/docs/images/uvision2.png
diff --git a/docs/images/uvision3.png b/docs/images/uvision3.png
diff --git a/docs/images/vscode1.png b/docs/images/vscode1.png
diff --git a/docs/images/vscode2.png b/docs/images/vscode2.png
diff --git a/docs/images/vscode3.png b/docs/images/vscode3.png
diff --git a/docs/images/vscode4.png b/docs/images/vscode4.png
diff --git a/docs/images/vscode5.png b/docs/images/vscode5.png
diff --git a/docs/images/with_mbed.png b/docs/images/with_mbed.png
diff --git a/docs/introduction/examples.md b/docs/introduction/examples.md
@@ -0,0 +1,107 @@
+## Examples and Videos
+
+### Blinky
+
+- [Blinky](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-blinky/): our basic application, showing how to use the APIs to control the LED on the board.
+
+### End to end projects
+
+- [LoRa on Arm Mbed](https://docs.mbed.com/docs/lora-with-mbed/en/latest/)
+- [Internet connected lighting system](https://docs.mbed.com/docs/building-an-internet-connected-lighting-system/en/latest/)
+
+### Our YouTube channel
+
+[https://www.youtube.com/armmbed/](https://www.youtube.com/armmbed/)
+
+### BBC micro:bit
+
+A few micro:bit How To videos:
+
+- [Hello world](https://www.youtube.com/watch?v=Jctpi6aqrHQ)
+- [Accelerometer](https://www.youtube.com/watch?v=_WGKBxSW_AE)
+- [Proximity heart](https://www.youtube.com/watch?v=xKWQSjg6rX4)
+
+### JavaScript on Arm Mbed OS 5
+
+- [Building IoT devices with JavaScript](https://os.mbed.com/javascript-on-mbed/)
+- [Blinky in JavaScript](https://github.com/ARMmbed/mbed-js-example)
+- [Bluetooth Low Energy in JavaScript](https://github.com/ARMmbed/mbed-js-ble-example)
+- [JavaScript REPL](https://github.com/janjongboom/mbed-js-repl-example)
+
+### Component examples
+
+#### Security
+
+##### Arm Mbed TLS
+
+- [Cryptographic benchmark](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-tls-benchmark/): benchmarks the various cryptographic primitives offered by Arm Mbed TLS.
+- [Authenticated encryption and decryption](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-tls-authcrypt/): performs authenticated encryption and authenticated decryption of a buffer. It serves as a tutorial for the basic authenticated encryption functions of Mbed TLS.
+- [Hashing](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-tls-hashing/): performs hashing of a buffer with SHA-256 using various APIs. It serves as a tutorial for the basic hashing APIs of Mbed TLS.
+- [TLS client](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-tls-tls-client/): downloads a file from an HTTPS server (os.mbed.com) and looks for a specific string in that file.
+
+##### Arm Mbed uVisor
+
+- [Threaded Blinky with uVisor](https://github.com/ARMmbed/mbed-os-example-uvisor-thread): an example threaded application with uVisor security.
+- [IRQ Blinky uVisor](https://github.com/ARMmbed/mbed-os-example-uvisor): an example threaded application with uVisor security and IRQ support.
+- [Threaded REPC with uVisor](https://github.com/ARMmbed/mbed-os-example-uvisor-number-store): using uVisor APIs to build a box that stores a number.
+
+These examples work on the K64F and the GNU Arm Embedded toolchain only.
+
+#### Core features
+
+##### File system
+
+[Get the FAT file system working on an Mbed OS platform](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-fat-filesystem/).
+
+##### Bootloader
+
+- [Create a bootloader](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-bootloader/).
+- [Use a blinky application with a prebuilt bootloader](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-bootloader-blinky/).
+
+#### mbed Client
+
+[Getting started](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-client/): a basic example of mbed Client for Mbed OS. It demonstrates how to register a device with Mbed Device Connector, how to read and write values and how to deregister.
+
+### Connectivity
+
+- [HTTP](http://github.com/armmbed/mbed-os-example-http) and [HTTPS](https://github.com/ARMmbed/mbed-os-example-tls/blob/master/tls-client/main.cpp).
+- [MQTT](https://os.mbed.com/teams/mqtt/code/HelloMQTT/).
+- [CoAP](https://github.com/armmbed/mbed-os-example-coap).
+
+#### mesh
+
+[Join a device to an insecure 6LoWPAN-ND or Thread network](https://os.mbed.com/teams/mbed-os-examples/code/nanostack-border-router). This is the simplest use of the mesh networking stack.
+
+#### Nanostack border router
+
+[Use the generic Mbed border router and create a 6LoWPAN-ND or Thread network](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-mesh-minimal/). Your 6LoWPAN or Thread devices can access to internet using this gateway.
+
+#### Sockets
+
+[Perform a transaction over TCP using the network-socket API](https://github.com/ARMmbed/mbed-os-example-sockets).
+
+#### Wi-Fi
+
+[Perform simple HTTP operations using the Wi-Fi interface](https://github.com/ARMmbed/mbed-os-example-wifi).
+
+#### Bluetooth Low Energy (BLE)
+
+- [Battery level](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-BatteryLevel/): use the Battery Level service to transmit a device's battery level.
+
+- [BLE button](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-Button/): BLE service template for a read-only characteristic.
+
+- [GAP button](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/): use GAP to transmit a value to a peer that's listening for advertisements.
+
+- [Heart rate](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-HeartRate/): transmit a heart rate value using the SIG Heart Rate profile.
+
+- [Thermometer](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-Thermometer/): send thermometer information using the Health Thermometer Profile.
+
+- [Simple LED control](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-LED/): a client using a read/write characteristic to control an LED. This example goes with the [LED blinker](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-LEDBlinker/), a server that uses the GATT client API to control the BLE client device.
+
+- Beacons send a small amount of information to a nearby device. Try:
+    - [BLE beacon](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-Beacon/).
+    - [Eddystone beacon](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-EddystoneService/). Try it with the [Eddystone observer](https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-ble-EddystoneObserver/), which scans for beacons.
+
+#### Peripherals
+
+[On os.mbed.com](https://os.mbed.com/teams/mbed_example/)
diff --git a/docs/introduction/introduction.md b/docs/introduction/introduction.md
@@ -0,0 +1,86 @@
+## Mbed OS 5
+
+Arm Mbed OS lets you write applications that run on embedded devices, by providing the layer that interprets your application's code in a way the hardware can understand.
+
+Your application code is written in C and C++. It uses the *application programming interfaces* (APIs) that Mbed OS provides. These APIs allow your code to work on different microcontrollers in a uniform way. This reduces the challenges of getting started with Arm-based microcontrollers and integrating large software projects.
+
+#### Where to start
+
+<span class="tips">If you're working on Windows, you might need to [install a serial driver](/docs/v5.6/tutorials/windows-serial-driver.html).</span>
+
+The easiest way to work with Mbed OS is using one of our development tools. We've set up an example, [Blinky](/docs/v5.6/tutorials/your-first-arm-mbed-application.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 [how to write your own applications](/docs/v5.6/reference/index.html).
+
+##### Development tools
+
+- Our offline development tool is [Arm Mbed CLI](/docs/v5.6/tools/mbed-cli.html), a command-line tool. This requires having a toolchain installed on your computer.
+- The [Arm Mbed Online Compiler](/docs/v5.6/tools/arm-mbed-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.6/tools/exporting.html).
+
+##### Communicating with and monitoring your board
+
+You can [monitor and control an Mbed board](/docs/v5.6/tutorials/serial-communication-overview.html) to help you debug and test your applications.
+
+<span class="tips">**Tip:** You can learn more about debugging [here](/docs/v5.6/tutorials/debugging-applications.html).</span>
+
+#### How to continue
+
+When you've started writing applications using your selected development tool:
+
+- Learn about [collaborative work and version control](/docs/v5.6/tools/collab-online-comp.html).
+- Try one of the [tutorials](/docs/v5.6/tutorials/index.html), which cover concepts such as debugging and memory tracing.
+- Ask questions and give advice on the [forum](https://forums.mbed.com/).
+
+#### Contributing to Mbed OS
+
+If you want to contribute to the `mbed-os` codebase, please see [the contribution section](/docs/v5.6/reference/contributing-overview.html).
+
+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 [contributing targets](/docs/v5.6/reference/contributing-target.html).
+- Information about the [tools you need to contribute targets](/docs/v5.6/reference/contributing-tools.html).
+- APIs about [storage](/docs/v5.6/reference/contributing-storage.html) and [connectivity](/docs/v5.6/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 [Mbed board](/docs/v5.6/introduction/how-mbed-works.html):
+
+<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>
+
+#### How programming works
+
+There are two options:
+
+1. When you plug an Mbed Enabled board to your PC using USB, it appears as a USB flash disk. The Mbed interface presents this small disk. It allows you to save Arm microcontroller binaries you want to run directly on to the board, without drivers.
+2. The same USB connection exposes a debug protocol such as CMSIS-DAP. This enables lots of IDEs to program and debug the device.
+
+##### How USB serial works
+
+The Arm Mbed interface also presents a USB serial/com interface. This is basically a UART-USB bridge, and it connects to the interface's UART. So if you send characters out of the target board's UART, the Arm Mbed interface will read them and transfer them over the USB link. When you `printf()`, it is just sending characters to UART. This means that if you make your own PCB, these characters will still appear on UART.
+
+##### Notes
+
+The `.bin` files the Mbed microcontroller accepts are standard raw binaries. Use any compiler you like to generate them. As the separate interface manages programming over JTAG or SWD, you have unlimited control of the target microcontroller. You really are just loading on a raw binary; this means you can build your own PCB using the same target microcontroller, and the same program binary will run on that.
+
+#### The Arm Mbed interface
+
+You can find more information about the Mbed interface and the circuits on which it runs in the [HDK reference manual](/docs/v5.6/reference/contributing-tools.html#arm-mbed-hdk) or on the [DAPLink GitHub page](https://github.com/ARMmbed/DAPLink/blob/master/README.md). The HDK includes reference circuits you can use to create your own boards, and DAPLink is the firmware that runs on these circuits.
+
+#### Connectivity
+
+The best representation of the connectivity of the Mbed interface is the same diagram we showed above.
+
+The Mbed interface:
+
+- Provides a USB connection to the host computer, which exposes a Mass Storage (flash disk) and a USB serial port.
+- Has an SWD or JTAG connection to the target, so it can program the target flash. You can also use this for debugging.
+- A physical UART connection exists between the target and the interface, which is relayed over the interface's USB serial port.
diff --git a/docs/introduction/terms.md b/docs/introduction/terms.md
@@ -0,0 +1,149 @@
+## Glossary
+
+### A
+
+**API** - [Application programming interface](/docs/v5.6/reference/api.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 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 Online Compiler** - [Arm’s online tool](/docs/v5.6/tools/online.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 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.
+
+### 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).
+
+**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.
+
+**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.
+
+**Board** - An Mbed Enabled development board. You can see a complete list of these [here](https://os.mbed.com/platforms/).
+
+**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.
+
+**Build Profile** - Mbed OS 5 supports three primary [build profiles](/docs/v5.6/tools/mbed-cli.html#build-profiles): 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/api-references.html#callback) 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/api-references.html#can).
+
+**Class** - An extensible program-code-template for creating objects, providing initial values for state and implementations of behavior.
+
+**CI** - Continuous integration.
+
+**CLI** - Command-line interface.
+
+**CMSIS-DAP** - The precursor to DAPLink, this [project](https://github.com/mbedmicro/cmsis-dap) is deprecated due to known bugs. You should not use it in any new designs.
+
+### D
+
+**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.
+
+**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.
+
+### 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.
+
+### 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/api-references.html#i2c) (short-distance, intraboard communication).
+
+**IDE** - Integrated Development Environment.
+
+**int** - Short for "integer", it is a variable type that can be used to define numeric variables holding whole numbers.
+
+### L
+
+**Library** - A module that you can use to build applications.
+
+**LoRA** - Long range (low power wireless platform).
+
+### M
+
+**Makefile** - A file containing a set of directives used with the make build automation tool.
+
+**Mesh** - A network topology in which each node relays data for the network.
+
+**Module** - A self-contained unit of code containing classes and functions.
+
+### N
+
+**Nibble** - A unit of digital information that consists of 4 bits (see `Bit`).
+
+### P
+
+**Platform** - See `board`.
+
+**Porting** - A process to add target support to Mbed OS.
+
+**Program** - See `application`.
+
+**Pull Request** - Used by version-controlled repositories to propose and collaborate on changes.
+
+### R
+
+**REST** - Representational State Transfer (API).
+
+**RTOS** - [Real-Time Operating System](/docs/v5.6/reference/rtos-api.html).
+
+### S
+
+**Serial** - A [protocol](/docs/v5.6/reference/api-references.html#serial) used in data transmission for the transfer of individual bits of information.
+
+**SPI** - [Serial Peripheral Interface](/docs/v5.6/reference/api-references.html#spi).
+
+**Static Memory** - The allocation of memory at compile time, before the program is executed.
+
+**SSL** - Secure sockets layer.
+
+**STLink** - STMicro's [firmware](http://www.st.com/content/st_com/en/products/embedded-software/development-tool-software/stsw-link007.html) that performs the same tasks as DAPLink but uses a different [driver](http://www.st.com/content/st_com/en/products/embedded-software/development-tool-software/stsw-link009.html).
+
+### T
+
+**Target** - See [`board`](/docs/v5.6/introduction/glossary.html#board).
+
+**Terminal Application** - [Applications](/docs/v5.6/tutorials/serial-communication.html#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).
+
+**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.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		<mxfile userAgent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4" version="6.8.9" editor="www.draw.io" type="device"><diagram id="d7a15faf-bf4b-0056-54cb-1d26b8fdf24f" name="Page-1">zZZbc6IwFIB/De+QIOCjS2m7D1VH2NnnCAfINBAnxqL76zdAVGjoXqY81AcnfCeXk+9kAhYOq/OTIIfyhWfALGRnZws/WAj5vqv+W3DpwQJrUAia9ci5g5j+Ag1tTU80g+Ooo+ScSXoYw5TXNaRyxIgQvBl3yzkbr3ogBRggTgkz6U+aybKnAfLv/BloUV5XdrxlH9mT9LUQ/FTr9SyE8+7XhytynUtv9FiSjDcDhCMLh4Jz2beqcwisVXvV1o97/CB6y1tALf9lwKIf8EbYCa4Zd3nJy9VFtxto+9sW/taUVEJ8IGkbbVTxFStlxdSTo5rm+jqlNxASzgOk83kCXoEUF9VFR5dajT46KNDPzb0QrqdZOSgC8jUkuvjFbeq7ANXQDqZ9YMNH8ryLVqphx6vHyJCjRqszCX8X0+6fqgO2YrSoFZO87ZBTxkLOuOhmw9kCgsxV/CgFf4VBJEB77HnzCHacsWHsuqZhNGHYCWYw7BqGv6+TaLf7sU1ml1zRLGsnMTwTCPJ0yrOXBrDP5/GMFu88B0vDM8ITnpczaPYNzetNK3i72yRRmEQPhmW1KznWObZT8/q9So2I1p0qVyD+VIep+s1g2nXcsWnbvDMc25s40TOYDgzT4eZlu1lH6yT+MpJzXstYpzHxkvj0HXI768M7ZOqS/n/h6vH+Puxig28OHP0G</diagram></mxfile>