cleanup
add TODO
Move mentions of README to troubleshooting guides

Fixes #17
Merge branch 'issue-17'