add documentation on common troubleshooting problems
Merge pull request #203 from Medium/nick-docs

add documentation on common troubleshooting problems