update docs as suggested