Add detail to readme

README.rst

@@ -3,3 +3,53 @@ gpiozero
 ========
 
 A simple interface to everyday GPIO components used with Raspberry Pi
+
+*A work in progress*
+
+Motivation
+==========
+
+The "hello world" program in Java is at least 5 lines long, and contains 11 jargon words which students are taught to ignore.
+
+The "hello world" program in Python is one simple line. However, the "hello world" of physical computing in Python (flashing an LED) is similar to the Java program: 6 lines of code to flash an LED.
+
+Young children and beginners shouldn't need to sit and copy out several lines of text they're told to ignore. They should be able to read their code and understand what it means.
+
+Install
+=======
+
+Install with pip::
+
+    sudo pip install gpiozero
+    sudo pip-3.2 install gpiozero
+
+Usage
+=====
+
+Example usage for flashing an LED::
+
+    from gpiozero import LED
+    from time import sleep
+
+    led = LED(2)
+
+    while True:
+        led.on()
+        sleep(1)
+        led.off()
+        sleep(1)
+
+Development
+===========
+
+This project is being developed on `GitHub`_. Join in:
+
+* Provide suggestions
+* Help design the `API`_
+* Contribute to the code
+
+Alternatively, email suggestions and feedback to ben@raspberrypi.org
+
+
+.. _`GitHub`: https://github.com/RPi-Distro/python-gpiozero
+.. _`API`: https://github.com/RPi-Distro/python-gpiozero/issues/7