more changes to markdown doc