add troubleshoot.rst to track some common errors and solutions.

[seanchen]

add troubleshoot.rst to track some common errors and solutions. unable to connect to github.com is the first error.

[petebacondarwin]

We should definitely make a note of this problem as it comes up quite often.

I think though that a less verbose entry in README would be better.