[Docs] Promote OAuth instead of Basic auth.
[Docs] Promote OAuth instead of Basic auth.

Moved `Basic authentication` section to the bottom and added a small notice
regarding security.

gentlero/bitbucket-api