More readme clarifications and documentation
renamed:    README.mdown -> README.md