modified the included .md files for clarification