added parameter descriptions
added more information about authentication