Would it not be simpler to update the docs to not be wrong?