updated docs/comments