Now that the `README.adoc` files use includes and are not easily readable, we should provide instructions to generate the `README.html` files. We also need to remove some obsolete content, for example '.md' files that have been replaced with '.adoc' files.