microbit-foundation
diff --git a/‎README.md‎
Lines changed: 5 additions & 4 deletions b/‎README.md‎
Lines changed: 5 additions & 4 deletions
diff --git a/‎accessories/making-accessories.md‎
Lines changed: 27 additions & 7 deletions b/‎accessories/making-accessories.md‎
Lines changed: 27 additions & 7 deletions
diff --git a/‎bluetooth/apps-and-examples.md‎
Lines changed: 30 additions & 8 deletions b/‎bluetooth/apps-and-examples.md‎
Lines changed: 30 additions & 8 deletions
@@ -2,10 +2,11 @@
 
 # Microbit Developer Community Docs
 
-These docs are rendered into the [micro:bit Developer Commmunity site](http://tech.microbit.org) (also known as the micro:bit tech site).
+These docs form the content that is rendered into the [micro:bit Developer Commmunity site](http://tech.microbit.org)
 
-Contributions are welcomed and encouraged, either by filing issues that you'd like to be fixed, or fixing documentation and submitting a pull request. Please review the [Foundation community and brand guidelines](https://microbit.org/community/) and the [tech.microbit.org](http://tech.microbit.org) homepage for further details about contribution.
+## Using these docs
 
-Documentation development tools
- - [microbit image maker](https://pycomic.github.io/microbit.html)
+These docs are made available under a Creative Commons license, to support the micro:bit community. Issues and Pull Requests are welcomed and encouraged. Please review the [Foundation community and brand guidelines](https://microbit.org/community/) and the [tech.microbit.org](http://tech.microbit.org) homepage for further details about contribution.
+
+**Documentation development tools**
  - The docs are mostly written in [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) 
@@ -1,26 +1,46 @@
 ---
 layout: page
 heading: Making accessories for the micro:bit
-description: If you'd like to make accessories for the micro:bit, pay attention to the details on this page.
+description: Information on making accessories and peripherals for the  micro:bit
 permalink: /accessories/making-accessories/
 lang: en
-assigned-to: jonnya
 ---
 
-# Using the Edge Connector
+## Accessory list
 
-The micro:bit card edge connector, commonly referred to as the 'edge connector' or the pins is designed to make accessory design easy. Many common micro:bit accessories work by placing a female edge connector on the board. However, there are limitations to the current that can be drawn from the micro:bit, and accessories must be designed carefully to ensure they do not damage the micro:bit, or that the micro:bit cannot damage them.
+A [list of available accessories](https://microbit.org/buy/accessories/) is maintained on the micro:bit website.
+
+[submit an accessory](https://form.jotformeu.com/83453273451355){: .btn.sm-btn}
+
+## Using the Edge Connector
+
+The micro:bit card edge connector, commonly referred to as the 'edge connector' or the 'pins' makes accessory design easy. 
+
+Many micro:bit accessories are designed to use an edge connector socket, so it is simple
+to plug in and remove the board. 
+
+There are limitations to the current that can be drawn from the micro:bit, and accessories must be designed carefully to ensure they do not damage the micro:bit, or that the micro:bit cannot damage them.
+
+### V2 revision
+The edge connector on the <span class="V2">V2</span> board revision is backwards compatible with the <span class="v1">v1</span> edge connector, but has additional dedicated pins.
 
 * Details of the [edge connector and pinout](/hardware/edgeconnector)
 * Details about [powering things from the board](/hardware/powersupply)
 
-
-# Battery Pads
+## Battery Pads
 
 There are two lozenge shaped pads on the back of the micro:bit. These allow you to connect a battery holder via a mechanism other than the JST connector.
 
+
 ![Picture of the two lozenges](/docs/accessories/assets/making-accessories-d7c25.png)
 
+### V2 revision
+In the <span class="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.
+
+- If you make an accessory that uses the lozenges, it must be protected from reverse charging
+when the board is powered by USB, battery or edge connector.
+- You can now source power from the lozenges if you are making an accessory, as they are consistent with the power architecture of the edge connector.
+
+Due to the addition of a speaker, current accessories that use the lozenges to power the micro:bit will no longer fit.
 
 
-.
 
@@ -9,28 +9,50 @@ ref: bluetooth
 lang: en
 ---
 
-# Overview
-
 Bluetooth applications can run on a variety of devices, including but not limited
 to smart phones and tablets. You can also run Bluetooth enabled applications
 on devices such as a Raspberry Pi.
 
 Below is a curated list of some Bluetooth applications you might like to read
-about and try for yourself with your micro:bit
+about and try for yourself with your micro:bit. Please contribute to this list
+if you know of any more. Many listed here are take from the [micro:bit Awesome list](https://github.com/carlosperate/awesome-microbit)
+
 
+## Applications, tools and examples
 
-## Applications
 
-[bitty software apps](https://bittysoftware.blogspot.com/p/applications.html)
+[Android App](https://play.google.com/store/apps/details?id=com.samsung.microbit) faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
 
-[Android App on Google Play](https://play.google.com/store/apps/details?id=com.samsung.microbit&hl=en_GB)
+[iOS App](https://apps.apple.com/gb/app/micro-bit/id1092687276)faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
 
-<a href="http://www.samsung.com/uk/microbit/" data-proofer-ignore>Samsung and micro:bit</a>
+[Swift Playgrounds](https://github.com/microbit-foundation/microbit-swift-playgrounds) contains a Playground Book available in the Swift app and a micro:bit Swift API to develop further resources
 
-[iOS App on iTunes](https://itunes.apple.com/gb/app/micro-bit/id1092687276?mt=8)
+[Scratch](https://scratch.mit.edu/microbit) facilitates a connection to the micro:bit and uses display, buttons and motion sensor services.
+
+[Bitty Software Apps](https://bittysoftware.blogspot.com/p/applications.html)
 
 [micro:bit Blue App for Android](https://github.com/microbit-foundation/microbit-blue)
 
 [droidscript microbit](http://www.microbit-js.org/controlling-microbit-with-droidscript/)
 
 [droidscript plugin](http://www.microbit-js.org/installing-the-microbit-plugin-for-droidscript/)
+
+[Kitronik Move](https://play.google.com/store/apps/details?id=com.kitronik.blemove) - Android app that presents a D-Pad interface to control a micro:bit over Bluetooth LE.
+
+[Workbench](https://edu.workbencheducation.com/partners/microbit) is amulti-device coding canvas for block-based programming that connects with BLE devices via Chrome Web Bluetooth.
+
+[microBit.js](https://github.com/antefact/microBit.js) - JavaScript library to interact with BBC micro:bit using web bluetooth API.
+
+[microbit-web-bluetooth](https://github.com/thegecko/microbit-web-bluetooth) - Web Bluetooth library implementing the micro:bit Bluetooth Profile.
+
+[microbit-web-components](https://github.com/thegecko/microbit-web-components) - Web Components for all the micro:bit features exposed via BLE.
+
+[Gobot](https://gobot.io/documentation/platforms/microbit/) - Framework for the Go programming language to program devices in the real world. It can access the micro:bit via Bluetooth LE.
+
+[micro:bit Slither](https://github.com/novucs/microbit-slither) - Multiplayer snake game on Android, controlled with micro:bits via Bluetooth.
+
+[Serial Bluetooth Terminal](https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal)- Android app capable to send and receive micro:bit Bluetooth UART data.
+
+[Bluetooth Low Energy Remote Control for Spotify](https://www.hackster.io/josejuansanchez/bluetooth-low-energy-remote-control-for-spotify-3438d1) - This project allows you to configure your micro:bit to work as a Bluetooth Low Energy remote control for Spotify on macOS.
+
+[Musical Instrument Controller](https://phwallen.github.io/microbit-music-controller/) - A micro:bit instrument that communities with an iPad via Bluetooth into MIDI controller app that can play music via GarageBand.