Adding installation instructions and fixes markdown snafu

Added the installation instructions now that you have to use `pip` to install requirements.
Aslo fixed the markup for the Examples section.
Fixes another markdown snafu
Merge branch 'develop'