add markdown to README and additional documentation