added more notes and formatted for markdown.