[docs] Document usage of username/password in Y.io config. Fix #1572

This PR includes both docs and api update.

/ping @triptych