Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure Portal, Azure PowerShell, and Azure CLI for all major management group operations. However, PowerShell examples are consistently presented before Azure CLI examples, and PowerShell-specific notes (such as parameter aliasing and output formatting) are included. The PowerShell examples use Windows-style prompts (e.g., 'PS C:\>'), and there are no explicit Linux shell examples or references to Linux-specific patterns or tools. The documentation does not mention Linux environments or provide Bash-specific guidance, which may make it less approachable for Linux users.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present them side-by-side to avoid implicit prioritization.
- Include explicit Bash shell examples where relevant, especially for scripting scenarios.
- Add notes clarifying that Azure CLI works cross-platform and provide guidance for Linux/macOS users (e.g., shell environment setup, authentication differences).
- Avoid Windows-specific prompt conventions (e.g., 'PS C:\>') unless also providing equivalent Linux shell prompts.
- Mention that both PowerShell and Azure CLI are available on Linux and macOS, and link to installation guides for those platforms.
- If referencing PowerShell-specific features (like parameter aliasing), clarify whether these apply to PowerShell Core on Linux/macOS.
Create Pull Request