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
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation page demonstrates a Windows bias by providing only PowerShell examples for command-line operations, with no equivalent examples for Linux shells (such as Bash or Azure CLI). The use of PowerShell-specific cmdlets (e.g., New-AzAppServicePlan, Set-AzAppServicePlan) and the absence of cross-platform or Linux-native tooling (like Azure CLI) may disadvantage users on Linux or macOS. The documentation also introduces PowerShell before any mention of ARM templates, reinforcing a Windows-first approach.
Recommendations:
- Add equivalent Azure CLI (az) examples for all PowerShell command-line instructions, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Explicitly mention that PowerShell examples are for Windows users and provide Bash/Azure CLI alternatives for Linux/macOS users.
- Consider reordering sections so that cross-platform tools (like Azure CLI or ARM templates) are presented before or alongside PowerShell.
- Where possible, provide guidance on how to accomplish the same tasks using REST API calls or SDKs, which are platform-agnostic.
- Review and update documentation metadata (such as ms.custom) to reflect support for cross-platform tools, not just Azure PowerShell.
Create pull request