added clarifying comments and links to resources in comments