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
⚠️
windows_first
Summary:
The documentation demonstrates a moderate Windows bias. PowerShell is featured prominently as a primary automation method, with detailed instructions and examples. There are several references to Windows-specific tools (e.g., Windows PowerShell as a console example), and PowerShell is mentioned before Azure CLI in most sections. While Azure CLI examples are provided (which are cross-platform), the documentation sometimes defaults to Windows-centric language and patterns, such as suggesting Windows PowerShell as the default local CLI environment, and does not explicitly mention or show Linux/macOS terminal usage or shell conventions.
Recommendations:
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell prompts for Bash (e.g., $) as well as PowerShell (e.g., PS>), or use neutral prompts.
- When referencing command-line environments, mention Bash or other Linux/macOS shells alongside Windows PowerShell.
- Balance the ordering of PowerShell and Azure CLI sections, or alternate their order to avoid always listing PowerShell first.
- Where possible, provide Bash-specific notes or examples, especially for multi-line commands or environment variable usage.
- Avoid language that assumes the user is on Windows (e.g., 'open a command console application such as Windows PowerShell'); instead, use neutral phrasing like 'open a terminal or command prompt.'
Create pull request