Update main README and demo/README (#284)

* Update main README and demo/README

* Update README, remove double spaces, bold some sections, etc

Author: dwalton76

README.rst

@@ -126,6 +126,9 @@ for ev3dev. The first allows you to run this program from Brickman, while the
 second imports this library.
 
 When saving Python files, it is best to use the ``.py`` extension, e.g. ``my-file.py``.
+To be able to run your Python code, **your program must be executable**. To mark a
+program as executable run ``chmod +x my-file.py``. You can then run ``my-file.py``
+via the Brickman File Browser or you can run it from the command line via ``$ ./my-file.py``
 
 User Resources
 --------------

demo/README.md

@@ -1,13 +1,45 @@
 # ev3dev demo programs
 
-This folder contains a bunch of demo programs that you can use to help you in
+This folder contains several demo programs that you can use to help you in
 developing your own code. Brief descriptions of each demo are provided below;
 you can access the full source code and some more detailed information on each
 by opening the respective folders above.
 
+To install these on your EV3, use git to clone the ev3dev-lang-python repository
+from github. Your EV3 will need Internet connectivty in order to clone the
+repository from github.
+```
+$ sudo apt-get install git
+$ git clone https://github.com/rhempel/ev3dev-lang-python.git
+```
+
+## Running A Program
+There are two ways to run a program. You can run a program from the command line
+or from the brickman interface.
+
+Note that for both running from the command line and running from Brickman the
+program **must be marked as an executable** and the **first line of the program
+must be** `#!/usr/bin/env python3`. To mark a program as executable run
+`chmod +x PROGRAM_NAME.py`. All of the demo programs are already marked as
+executable and already have `#!/usr/bin/env python3` so you should be fine, we
+only mention it so you know to do these things when writing your own programs.
+
+## Command Line
+To run one of the demo programs from the command line, cd to the directory and
+run the program via `./PROGRAM_NAME.py`. Example:
+```
+$ cd ev3dev-lang-python/demo/R3PTAR/
+$ ./r3ptar.py
+```
+## Brickman
+To run one of the demo programs from Brickman, select the program in the
+File Browser.
+
+## Demo Programs
 ### BALANC3R
 
-Laurens Valk's BALANC3R - This robot uses the gyro sensor to balance on two wheels. Use the IR remote to control BALANC3R
+Laurens Valk's BALANC3R - This robot uses the gyro sensor to balance on two
+wheels. Use the IR remote to control BALANC3R
 
 * http://robotsquare.com/2014/07/01/tutorial-ev3-self-balancing-robot/
 
@@ -31,7 +63,8 @@ David Gilday's MINDCUB3R
 
 ### TRACK3R
 
-A basic example of Object Oriented programming where there is a base TRACK3R class with child classes for the various permutations of TRACK3R
+A basic example of Object Oriented programming where there is a base TRACK3R
+class with child classes for the various permutations of TRACK3R
 
 * http://www.lego.com/en-us/mindstorms/build-a-robot/track3r
 * TRACK3R.py