Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a Windows bias by prioritizing Windows tools and workflows, such as PowerShell and ARMClient, and by referencing Windows-specific installation instructions before cross-platform alternatives. PowerShell is introduced and used before Azure CLI, and ARMClient (a Windows-centric tool) is listed as a prerequisite. There is a lack of explicit Linux/macOS installation or usage guidance, and no mention of Linux-specific shell or scripting examples.
Recommendations
- Provide cross-platform installation instructions for Azure CLI and ARMClient, including Linux and macOS, not just Windows.
- Present Azure CLI examples before or alongside PowerShell examples, as CLI is cross-platform.
- Include bash or shell script examples for Linux/macOS users where scripting is demonstrated.
- Clarify that ARMClient can be used on non-Windows platforms (if true), or suggest alternative tools for Linux/macOS.
- Balance references to PowerShell and CLI throughout the document, ensuring neither is given undue prominence.
- Explicitly mention platform compatibility for all tools and commands.
- Add a table or section summarizing tool/platform compatibility and installation links for Windows, Linux, and macOS.
Create Pull Request