Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for all major tasks, but PowerShell examples are always presented immediately after CLI, and CLI examples use Bash-style syntax (variables, curl) that is compatible with Linux/macOS. However, there is a subtle Windows bias: PowerShell is featured as the only alternative to CLI, with no mention of Linux-native scripting options (e.g., Python, Bash scripts), and PowerShell examples may be less accessible to Linux/macOS users. The CLI examples are generally cross-platform, but the documentation does not explicitly address Linux/macOS users or provide guidance for those environments.
Recommendations
- Explicitly state that Azure CLI examples are cross-platform and suitable for Linux/macOS users.
- Add notes or sections clarifying how to run CLI examples on Linux/macOS, including prerequisites (e.g., installing Azure CLI, using Bash).
- Consider providing Bash script examples for common tasks, or referencing Linux-native tools where appropriate.
- If PowerShell is included, clarify that PowerShell Core is available on Linux/macOS, or provide links to installation instructions.
- Add a short section or callout for Linux/macOS users to ensure parity and inclusivity.