updated comments/documentation and github link