I agree we can enhance the documentation.  This is intended to be a quick fix as what is currently deployed references the way v1 does authentication and is wrong.