update docs for previous breaking change