update README content; align with project site
use modern syntax in CONTRIBUTING; add note about verbose mode