Added getting started overview

docs/source/boards/iot-bus-io.rst

@@ -34,7 +34,7 @@ Pins Used
     - On-board LED
 
 .. note:: Pin 5 is the default SS for the vSPI interface and provided you are not using 
-them at the same time it will work just fine for either purpose.
+  them at the same time it will work just fine for either purpose.
 
 Schematic
 ---------

docs/source/getting-started/iot-bus-getting-started-with-mozilla.rst

@@ -0,0 +1,4 @@
+.. _getting-started-with-mozilla-iot:
+
+Getting Started with Mozilla IoT
+================================

docs/source/getting-started/iot-bus-getting-started.rst

@@ -3,4 +3,66 @@
 Choosing a Platform and Framework
 =================================
 
-Here's where the getting started goes.
+One of the great things about IoT-Bus is that you're free to choose from a large number of platforms and
+frameworks. You know that you want to create an IoT project but where do you start? 
+In our view it very depends on what you know now. 
+
+
+Arduino
+-------
+
+If you have never programmed or know nothing about embedded hardware then you may be best to 
+start with Arduino as a framework and as an editor and programmer. 
+Similarly, if you are in education and do not want to be explaining things to yous students about the IDE and 
+just want to create very simple applications then again, you may pick
+Arduino as a Framework and as your development environment. Many, many users have chosen Arduino overs the years 
+and many still do. It's a great place to start.
+
+PlatformIO
+----------
+
+On the other hand if you are a professional programmer or a serious hobbyist then you will 
+probably pick PlatformIO. There are other environments that are just fine if you already use them like Eclipse or NetBeans.
+But if you are investing your time and money in the future then PlatformIO is the way to go. 
+Similarly, if maintaining source code integrity, versioning and testing and debugging  are becoming more important you as a Arduino user then take a look at PlatformIO. 
+The advantage that PlatformIO has taken of leveraging an excellent open IDE from Microsoft and extending it, again, in open fashion to the embedded world
+is really excellent. 
+
+Now in terms of framework you again have a choice. Arduino or esp-idf are the c++ development choices. 
+Arduino is simpler and more "black-box" - you can get going very quickly and without necessarily fully understanding 
+everything you can get an IoT project up and running. However, if things like a multi-tasking environment and the availability of 
+professional-class libraries and support are more important then esp-idf is more likely to be the framework for you. 
+It is lower-level and you may have to do more work but you are also more likely to get a professional application as a result.
+
+There is a "third-way" option of using Platformio as your development environment and using 
+Arduino as your framework if you are a new user or already familiar with Arduino libraries. This option perhaps gives you the best of both worlds. 
+You're able to get up and running quickly and it would be easier to move to esp-idf you should choose to.
+
+MicroPython
+-----------
+
+Python is becoming ubiquitous (this documentation was produced using it!). 
+And MicroPython is a great implementation of python for the embedded environment.
+So if you are already familiar with python that's a great way to leverage the IoT-BUs platform. 
+We'll show you later in this section how to get started with it.
+
+moddable
+--------
+
+Javascript is another great alternative. It's not only used in front-end code, there are 
+dedicated servers for it and a whole development infrastructure that has sprung up around it.
+And moddable is the company that just "does javascript right'. We'll show you later in this section how to get started with it.
+
+Summary
+-------
+
+So what would I do today? I'd get started! Buy a kit from oddWires. Take a look at Arduino, PlatformIO, MicroPython or moddable.
+You'll find more projects on the web that Arduino based so if you want to find 
+somebody that's done something similar to what you want to do. You'll probably find it as an Arduino project somewhere. 
+It's also not hard to take that same project and import it into PlatformIO and take it from there.
+
+If you're a seasoned C++ programmer then PlatformIO and the esp-idf framework is probably the way to go. 
+MicroPython and moddable are great choices if you are already familiar with python or javascript respectively.
+Lastly there are other choices that may be even better when teaching students graphically such as MicroBlocks which runs wonderfully on IoT-Bus
+and does not require traditional line-by-line programming.
+

docs/source/index.rst

@@ -61,6 +61,8 @@ Welcome to oddWires IoT-Bus
 
    getting-started/iot-bus-getting-started-with-esp-idf
 
+   getting-started/iot-bus-getting-started-with-mozilla
+
    getting-started/iot-bus-getting-started-with-micro-python
 
    getting-started/iot-bus-getting-started-with-moddable
@@ -101,7 +103,6 @@ Welcome to oddWires IoT-Bus
    :caption: Mozilla-IoT Tutorials
    :maxdepth: 1
 
-   tutorials/iot-bus-mozilla-led
    tutorials/iot-bus-mozilla-dht11
    tutorials/iot-bus-mozilla-relay    
 

docs/source/tutorials/iot-bus-mozilla-dht11.rst

@@ -1,4 +1,4 @@
 .. _iot-bus-mozilla-dht11:
 
-Creating a Mozilla "Thing" - Temperature and Humidity Sensor
-============================================================
+Creating a Mozilla IoT "Thing" - Temperature and Humidity Sensor
+================================================================

docs/source/tutorials/iot-bus-mozilla-relay.rst

@@ -1,4 +1,4 @@
 .. _iot-bus-mozilla-relay:
 
-Creating a Mozilla "Thing" - Relay Controller
-=============================================
+Creating a Mozilla IoT "Thing" - Relay Controller
+=================================================