break detector logic out, add specs. Resolves #1
add Contribution Guidelines
Merge branch 'feature/issue-1/better-detector' into develop
update README to reflect underlying changes.