(doc) adds troubleshooting section and cleans up README.md