update docs for interface usage