update docs (added info about units)