added a markdown doc and made some tweaks