replacement_params docs bit moved to the original API