modified documentation to be in sync with the new approach