misc: Remove outdated README

There's no point in keeping two similar README's around, and README.md
is better maintained.
misc: Add a Documentation section to README.md
misc: Add a Contributing section to README.md