Improved install docs

Added sections on which Python version and installing from github.
Added list of things to include when reporting errors to the mailing
list.
A more friendly note on Python 3 compatibility

@biroles said that it was a bit too harsh.
Merge pull request #84 from leouieda/docs-install

Improved install docs