update docs to the new syntax