About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation page exclusively uses Azure PowerShell for all setup, configuration, and management steps, with all code samples and variable paths (e.g., certificate paths) reflecting Windows conventions. There are no examples or guidance for performing the same tasks using cross-platform tools such as Azure CLI, Bicep, or ARM templates, nor are there any Linux/macOS-specific instructions or file path conventions. This creates a strong Windows and PowerShell bias, making it less accessible for users on Linux or macOS systems.
Recommendations:
- Provide equivalent Azure CLI examples for all major steps, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include notes or examples for Linux/macOS users, especially regarding file paths (e.g., use /home/contoso/ instead of C:\Users\Contoso\).
- Reference and link to ARM/Bicep template-based deployments for users who prefer declarative infrastructure-as-code approaches.
- Explicitly state that all steps can be performed on Linux/macOS with Azure CLI, and highlight any differences or prerequisites.
- Where PowerShell is required, clarify if Azure PowerShell Core (cross-platform) is supported, and provide installation instructions for non-Windows systems.
- Add a section or callout summarizing cross-platform options for managing Azure resources, with links to relevant documentation.
Create pull request