Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell examples are consistently provided alongside Azure CLI, with PowerShell listed first in most code tabs. Variable assignment syntax in CLI examples uses Windows-style ($Var=...) rather than POSIX/Bash style (Var=...), which may confuse Linux/macOS users. There is no explicit mention of Linux/macOS shell usage or differences, and no Bash-specific guidance or troubleshooting. The documentation assumes familiarity with PowerShell and Windows conventions, and does not provide parity for Linux/macOS users in terms of example ordering or shell-specific notes.
Recommendations
- Provide Bash-specific CLI examples using POSIX variable assignment (e.g., VarName="value") and usage.
- Alternate the ordering of PowerShell and CLI examples, or default to CLI first, as CLI is cross-platform.
- Add explicit notes or sections for Linux/macOS users, clarifying shell differences and any required environment setup.
- Where PowerShell is mentioned, clarify that it is available cross-platform, but provide Bash alternatives for Linux/macOS.
- Review variable assignment and scripting conventions to ensure they are compatible with Bash/zsh/fish shells.
- Consider adding troubleshooting or FAQ sections for common Linux/macOS issues.
Create Pull Request