update contributing details

Improve README.md and CONTRUBTING.md. Fixes #174.

NOTE: purposely PRing to `master`