updating docs and comments