doc: update documentation to point to security best practice

[cuiy0006]

This change is 

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.91%. Comparing base (63bc533) to head (b9cc1e3).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #14942   +/-   ##
=======================================
  Coverage   92.91%   92.91%           
=======================================
  Files        2351     2351           
  Lines      210082   210082           
=======================================
+ Hits       195202   195203    +1     
+ Misses      14880    14879    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[scotthart]

Reviewable status: 0 of 3 files reviewed, 2 unresolved discussions (waiting on @cuiy0006)

---

google/cloud/credentials.h line 122 at r2 (raw file):

 *   credentials.
 *
 * Important: If you accept a credential configuration (credential

s/Important:/@warning

This will add some additional highlighting during doc rendering.

Code quote:

Important:

---

google/cloud/credentials.h line 276 at r2 (raw file):

 * Azure, or SAML 2.0.
 *
 * Important: If you accept a credential configuration (credential

s/Important:/@warning

This will add some additional highlighting during doc rendering.

Code quote:

Important: