feat(azure): improve docstrings

[pedrooot]

Description

This pull request includes an enhancement to the AzureProvider class in the prowler/providers/azure/azure_provider.py file. The main change is the addition of usage examples to the __init__ method's docstring, demonstrating various ways to instantiate the AzureProvider class.

Enhancements to documentation:

• prowler/providers/azure/azure_provider.py: Added detailed usage examples for different authentication methods (static credentials, Azure CLI, Service Principal environment, interactive browser, and managed identity) to the __init__ method's docstring.

Checklist

• Are there new checks included in this PR? Yes / No
  • If so, do we need to update permissions for the provider? Please review this carefully.
• Review if the code is being covered by tests.
• Review if code is being documented following this specification https://github.com/google/styleguide/blob/gh-pages/pyguide.md#38-comments-and-docstrings
• Review if backport is needed.

License

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 89.88%. Comparing base (344d541) to head (db757ec).
Report is 11 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #5715      +/-   ##
==========================================
- Coverage   89.94%   89.88%   -0.06%     
==========================================
  Files        1124     1128       +4     
  Lines       34815    35182     +367     
==========================================
+ Hits        31313    31622     +309     
- Misses       3502     3560      +58     

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