update docs from petrizzo