bluetooth: Documentation of mojo interfaces

device/bluetooth/README.md

-Bluetooth
-=========
+# Bluetooth
 
 `device/bluetooth` abstracts
 [Bluetooth Classic](https://en.wikipedia.org/wiki/Bluetooth) and
 [Low Energy](https://en.wikipedia.org/wiki/Bluetooth_low_energy) features
 across multiple platforms.
 
 Classic and Low Energy based profiles differ substantially. Platform
 implementations may support only one or the other, even though several classes
 have interfaces for both, e.g. `BluetoothAdapter` & `BluetoothDevice`.
 
 |           | Classic |  Low Energy |
 |-----------|:-------:|:-----------:|
 | Android   |   no    |     yes     |
 | Chrome OS |   yes   |     yes     |
 | Linux     |   yes   |     yes     |
 | Mac       |   yes   |     yes     |
 | Windows   |   some  |    nearly   |
 
 Chrome OS and Linux are supported via BlueZ, see `*_bluez` files.
 
+[Mojo](https://www.chromium.org/developers/design-documents/mojo)
+interfaces in [public/interfaces](public/interfaces) have been started
+but are *not* ready for production use.
 
-Maintainer History
---------------------------------------------------------------------------------
+
+## Maintainer History
 
 Initial implementation OWNERS were youngki@chromium.org, keybuk@chromium.org,
 armansito@chromium.org, and rpaquay@chromium.org. They no longer contribute to
 chromium fulltime. They were responsible for support for Chrome OS Bluetooth
 features and the Chrome Apps APIs:
 
 * [chrome.bluetooth](https://developer.chrome.com/apps/bluetooth)
 * [chrome.bluetoothLowEnergy](https://developer.chrome.com/apps/bluetoothLowEnergy)
 * [chrome.bluetoothSocket](https://developer.chrome.com/apps/bluetoothSocket)
 
 Active development in 2015 & 2016 is focused on enabling GATT features for:
 
 * [Web Bluetooth](https://crbug.com/419413)
 * Peripheral mode for Chrome OS.
 
 Known future work is tracked in the
 [Refactoring meta issue](https://crbug.com/580406).
 
 
-Testing
---------------------------------------------------------------------------------
+## Testing
 
 Implementation of the Bluetooth component is tested via unittests. Client code
 uses Mock Bluetooth objects:
 
 
 ### Cross Platform Unit Tests
 
 New feature development uses cross platform unit tests. This reduces test code
 redundancy and produces consistency across all implementations.
 
@@ skipping 29 matching lines @@
 
 ### Chrome OS Blueooth Controller Tests
 
 Bluetooth controller system tests generating radio signals are run and managed
 by the Chrome OS team. See:
 https://chromium.googlesource.com/chromiumos/third_party/autotest/+/master/server/site_tests/
 https://chromium.googlesource.com/chromiumos/third_party/autotest/+/master/server/cros/bluetooth/
 https://chromium.googlesource.com/chromiumos/third_party/autotest/+/master/client/cros/bluetooth/
 
 
-Android
---------------------------------------------------------------------------------
+## Android
 
 The android implementation requires crossing from C++ to Java using
 [__JNI__](https://www.chromium.org/developers/design-documents/android-jni).
 
 Object ownership is rooted in the C++ classes, starting with the Adapter, which
 owns Devices, Services, etc. Java counter parts interface with the Android
 Bluetooth objects. E.g.
 
 For testing, the Android objects are __wrapped__ in:
 `android/java/src/org/chromium/device/bluetooth/Wrappers.java`. <br>
@@ skipping 15 matching lines @@
                 * `android/.../Wrappers.java`: `BluetoothServiceWrapper`
                     * Which under test is a `FakeBluetoothService`
             * ... and so on for characteristics and descriptors.
 
 Fake objects are controlled by `bluetooth_test_android.cc`.
 
 See also: [Class Diagram of Web Bluetooth through Bluetooth Android][Class]
 
 [Class]: https://sites.google.com/a/chromium.org/dev/developers/design-documents/bluetooth-design-docs/web-bluetooth-through-bluetooth-android-class-diagram
 
-Design Documents
---------------------------------------------------------------------------------
+
+## Design Documents
 
 * [Bluetooth Notifications](https://docs.google.com/document/d/1guBtAnQUP8ZoZre4VQGrjR5uX0ZYxfK-lwKNeqY0-z4/edit?usp=sharing) 2016-08-26
     * Web Bluetooth through Android implementation details, class diagram and
       call flow.