Merge pull request #52 from neuromusic/fresh-docs

updated README
make 'Contents' a heading
fixed numbering
this should work