update docs and associated class.