README: add 'Reporting issues' section and formatting
Move README to README.md

This triggers proper syntax highlighting, also with Github.