style
connection: more comments
add note about auth method priority