Improve part of first contributor experience

Syntax errors in the sample json file, and typos in the README.
Merge pull request #253 from pquentin/master

Improve part of first contributor experience