Merge the content of BUGS into the README file
Use .adoc as the extension for AsciiDoc files in doc/
Rename README, INSTALL, and NEWS to end in .adoc

Add inter-document links to work on Github.