Move docs/generatingImpalaDoc.md to docs/README.md. This will
automatically render the document inline at places like:
https://github.com/apache/incubator-impala/tree/master/docs
under the directory listing.
Fix existing markdown which wasn't always rendering properly. Remove
unneeded HTML and backslashes. Add a mention of make, and add one
troubleshooting tip. Wrap most lines at 90 chars. This does not change
how Github renders the markdown, and it makes reading the source easier
as well.
Explain how to get dita into PATH.
Emphasize make and remove some of the dita advanced usage.
Change-Id: I71ae79ecd346045697fe225140ee9a317c5a337f
Reviewed-on: http://gerrit.cloudera.org:8080/6512
Reviewed-by: Jim Apple <jbapple-impala@apache.org>
Tested-by: Michael Brown <mikeb@cloudera.com>
