more comments, docs fix