updated docs, comments