Update README.md

Author: pdp7

README.md

@@ -1,42 +1,38 @@
-**PLEASE NOTE:  This library may have breaking changes as development continues.  Please read the changelog anytime you update the library!**
-
-**The PWM Duty Cycle range was reversed in 0.0.15 from 100(off)-0(on) to 0(off)-100(on).  Please update your code accordingly.**
-
-**Adafruit's BeagleBone IO Python Library**
+# Adafruit's BeagleBone IO Python Library
 
 This is a set of Python tools to allow GPIO, PWM, and ADC access on the BeagleBone using the Linux 3.8 Kernel and above (latest releases).
 
 It is recommended to use an official BeagleBoard.org Debian image:
 https://beagleboard.org/latest-images
 
-**Note: BBIO has been renamed to Adafruit_BBIO.**
 
-**Installation on Ubuntu/Debian**
+**NOTE: This library may have breaking changes as development continues. Please read the changelog.**
 
-Easiest::
+## Installation on Debian**
 
-    sudo ntpdate pool.ntp.org
-    sudo apt-get update
-    sudo apt-get install build-essential python-dev python-pip -y
-    #easy_install -U distribute  //debian only
-    sudo pip install Adafruit_BBIO
+Easiest:
+```
+sudo ntpdate pool.ntp.org
+sudo apt-get update
+sudo apt-get install build-essential python-dev python-pip -y
+sudo pip install Adafruit_BBIO
+```
 
-Manual::
-
-    sudo ntpdate pool.ntp.org
-    sudo apt-get update
-    sudo apt-get install build-essential python-dev python-pip -y
-    git clone git://github.com/adafruit/adafruit-beaglebone-io-python.git
-    cd adafruit-beaglebone-io-python
-    sudo python setup.py install
-    cd ..
-    sudo rm -rf adafruit-beaglebone-io-python
+Manual:
+```
+sudo ntpdate pool.ntp.org
+sudo apt-get update
+sudo apt-get install build-essential python-dev python-pip -y
+git clone git://github.com/adafruit/adafruit-beaglebone-io-python.git
+cd adafruit-beaglebone-io-python
+sudo python setup.py install
+```
 
-**Usage**
+## Usage
 
 Using the library is very similar to the excellent RPi.GPIO library used on the Raspberry Pi. Below are some examples.
 
-**GPIO Setup** 
+### GPIO Setup
 
 Import the library, and setup as GPIO.OUT or GPIO.IN::
 
@@ -47,15 +43,15 @@ You can also refer to the pin names::
 
     GPIO.setup("GPIO0_26", GPIO.OUT)
 
-**GPIO Output** 
+### GPIO Output
 
 Setup the pin for output, and write GPIO.HIGH or GPIO.LOW. Or you can use 1 or 0.::
 
     import Adafruit_BBIO.GPIO as GPIO
     GPIO.setup("P8_14", GPIO.OUT)
     GPIO.output("P8_14", GPIO.HIGH)
 
-**On-Board LEDs**
+### On-Board LEDs
 
 On-board LEDs (USR0-USR3) are handled by LED class driver rather than the GPIO pin driver.
 
@@ -77,37 +73,38 @@ Setup the pin for output and write GPIO.HIGH or GPIO.LOW::
             GPIO.output("USR%d" % i, GPIO.LOW)
             time.sleep(1)
 
-**GPIO Input**
+### GPIO Input
 
-Inputs work similarly to outputs.::
+Inputs work similarly to outputs.:
 
     import Adafruit_BBIO.GPIO as GPIO
     GPIO.setup("P8_14", GPIO.IN)
 
-Polling inputs::
+Polling inputs:
 
     if GPIO.input("P8_14"):
       print("HIGH")
     else:
       print("LOW")
 
-Waiting for an edge (GPIO.RISING, GPIO.FALLING, or GPIO.BOTH::
+Waiting for an edge (GPIO.RISING, GPIO.FALLING, or GPIO.BOTH:
 
     GPIO.wait_for_edge(channel, GPIO.RISING)
 
     or
 
     GPIO.wait_for_edge(channel, GPIO.RISING, timeout)
 
-Detecting events::
+Detecting events:
 
     GPIO.add_event_detect("P9_12", GPIO.FALLING) 
     #your amazing code here 
     #detect wherever: 
     if GPIO.event_detected("P9_12"):
       print "event detected!"
 
-**PWM**::
+### PWM
+**The PWM Duty Cycle range was reversed in 0.0.15 from 100(off)-0(on) to 0(off)-100(on).  Please update your code accordingly.**
 
     import Adafruit_BBIO.PWM as PWM 
     #PWM.start(channel, duty, freq=2000, polarity=0) 
@@ -122,7 +119,7 @@ Detecting events::
     #set polarity to 1 on start:
     PWM.start("P9_14", 50, 2000, 1)
 
-**ADC**::
+### ADC:
 
     import Adafruit_BBIO.ADC as ADC
     ADC.setup()
@@ -133,23 +130,20 @@ Detecting events::
     #read_raw returns non-normalized value 
     value = ADC.read_raw("P9_40")
 
-**Running tests**
+## Running tests
 
-Install py.test to run the tests. You'll also need the python compiler package for py.test.::
+Install py.test to run the tests. You'll also need the python compiler package for pytest:
 
-    opkg update && opkg install python-compiler 
-    #Either pip or easy_install 
     pip install -U pytest 
-    easy_install -U pytest
 
-Execute the following in the root of the project::
+Execute the following in the root of the project:
 
-    py.test
+    pytest
 
-**Credits**
+## Credits
 
 The BeagleBone IO Python library was originally forked from the excellent MIT Licensed [RPi.GPIO](https://code.google.com/p/raspberry-gpio-python) library written by Ben Croston.
 
-**License**
+## License
 
 Written by Justin Cooper, Adafruit Industries. BeagleBone IO Python library is released under the MIT License.