Document the special behavior of updating sql.Server passwords

[thomas11]

This documentation intends to help users when encountering this surprising behavior and addresses #2937 at least in the short-medium term.

I'm not a native speaker so please feel free to suggest changes.

[github-actions]

Does the PR have any schema changes?

Looking good! No breaking changes found.
No new resources/functions.

[danielrbradley]

Does this not update the schema because we don't commit the one with the docs included?

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 55.34%. Comparing base (1adf471) to head (d485f3a).

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3242      +/-   ##
==========================================
- Coverage   55.49%   55.34%   -0.16%     
==========================================
  Files          66       66              
  Lines        9929     9929              
==========================================
- Hits         5510     5495      -15     
- Misses       3991     4001      +10     
- Partials      428      433       +5     

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

[thomas11]

Does this not update the schema because we don't commit the one with the docs included?

Exactly. Here's the registry preview for the change.