more documentation. README -> README.md for doc-generaters.