updated file with links, clarifications, and formatting