Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples for all operations, but PowerShell (a Windows-centric tool) is consistently presented alongside CLI, and is sometimes referenced first for certain actions (e.g., accepting Marketplace terms). There is a notable emphasis on PowerShell usage, which may implicitly favor Windows users. There are no explicit Linux shell script examples (e.g., Bash), nor are Linux-specific tools or patterns mentioned. The documentation does not address platform-specific nuances, such as differences in scripting environments between Windows and Linux.
Recommendations
- Add explicit Bash script examples for Linux users, especially for multi-step operations.
- Clarify that Azure CLI is cross-platform and can be used natively on Linux, macOS, and Windows.
- Where PowerShell is referenced, note that PowerShell Core is available on Linux and macOS, or provide equivalent Bash commands.
- Avoid language that implies PowerShell is the default or preferred method; present CLI and PowerShell examples in parallel, or alternate which is shown first.
- Include notes or links for installing and using Azure CLI and PowerShell on Linux systems.
- Highlight any platform-specific considerations, such as environment variable syntax differences or file path formats.
Create Pull Request