Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page provides extensive PowerShell examples and references, which are primarily associated with Windows environments. PowerShell is presented as a first-class method alongside Azure CLI and portal, but its usage and file path conventions (e.g., C:\temp\json.txt) reinforce a Windows-centric approach. There are no Linux shell (bash) or cross-platform scripting examples, and file system references are Windows-specific. The documentation does not mention or provide parity for Linux-native tools, nor does it address platform differences in scripting or file handling.
Recommendations
- Add bash shell examples for all CLI operations, including scripting and file handling, to demonstrate Linux parity.
- Use platform-neutral file path conventions (e.g., /tmp/json.txt) or provide both Windows and Linux file path examples.
- Explicitly mention that Azure CLI works on Linux, macOS, and Windows, and provide guidance for installation and usage on non-Windows platforms.
- Where PowerShell is referenced, clarify that PowerShell Core is available cross-platform, and provide examples for Linux/macOS where file paths or behaviors differ.
- Avoid assuming a Windows environment in examples and instructions; where necessary, provide notes or alternatives for Linux users.
- Consider including references to Linux-native tools (e.g., curl for REST API calls) where appropriate.
Create Pull Request