Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell (a Windows-centric tool) is consistently presented first in command examples and explanations, with output samples shown in PowerShell format. The installation instructions and command syntax for PowerShell are more detailed than for Azure CLI. Output screenshots and text samples use PowerShell conventions, and confirmation prompts are shown in PowerShell style. There is no mention of Linux-specific shell environments (e.g., Bash), nor are there examples tailored for Linux users (such as using Bash scripting or Linux terminal conventions).
Recommendations
- Alternate the order of PowerShell and Azure CLI examples so that CLI is sometimes presented first, or present both side-by-side.
- Include explicit Bash/Linux shell examples and output, especially for Azure CLI commands.
- Show output samples in both PowerShell and CLI formats, or use CLI as the default for cross-platform parity.
- Mention that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows.
- Add notes or sections for Linux/macOS users, such as how to install Azure CLI on those platforms.
- Avoid using only PowerShell-style confirmation prompts; show CLI equivalents.
- Where possible, use generic terminology (e.g., 'terminal' instead of 'PowerShell window') and avoid Windows-specific language.
Create Pull Request