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_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing only PowerShell examples for Azure CLI commands, referencing Windows file paths (e.g., C:\Users\Downloads\...), and instructing users to use PowerShell to set up and run Azure CLI. There are no Linux/macOS shell examples, and instructions for copying file paths or interacting with the filesystem are written from a Windows perspective. This may hinder Linux or macOS users attempting to follow the guide.
Recommendations:
- Provide parallel command-line examples using Bash (sh) syntax for Linux/macOS alongside PowerShell examples.
- Use platform-agnostic file path placeholders (e.g., <path/to/certificate.pem>) or show both Windows and Unix-style paths in examples.
- Clarify that Azure CLI can be used from any OS and provide links or notes for Linux/macOS installation and usage.
- Include instructions for copying file paths or locating files on Linux/macOS systems.
- Avoid language such as 'right-click and copy the path' which is specific to Windows Explorer; instead, offer cross-platform alternatives.
Create pull request