Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all major tasks, ensuring Linux parity in command-line instructions. However, PowerShell instructions and references are consistently presented before Azure CLI equivalents, and PowerShell is mentioned as a primary method for deploying Bicep and ARM templates, which can create a perception of Windows-first bias. There are no sections that are Windows-only, and Linux/macOS users can complete all tasks using Azure CLI, Cloud Shell, or Terraform. No Windows-exclusive tools or patterns are used, and Cloud Shell (Bash) is highlighted as a cross-platform solution.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present CLI first in some sections to avoid implicit prioritization.
- Explicitly note that Azure CLI commands work on Linux/macOS and that Cloud Shell is available to all users, reinforcing cross-platform support.
- Where PowerShell is referenced as a deployment method for Bicep/ARM templates, clarify that Azure CLI is equally supported and provide CLI examples first or side-by-side.
- Consider adding a short section at the top stating that all command-line instructions are cross-platform unless otherwise noted.