update docs, comments