extra comments and updated docs