docs/comments update