Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a Windows bias by prioritizing PowerShell instructions and tools, referencing Windows-specific installation paths, and omitting explicit Linux/macOS guidance. PowerShell is presented before Azure CLI, and ARMClient (a .NET/Windows-centric tool) is recommended without alternatives. The Azure CLI installation link is for Windows only, and there are no Linux/macOS-specific notes or examples, especially in the prerequisites and tool installation sections.
Recommendations
- Provide Azure CLI installation instructions and links for Linux and macOS alongside Windows.
- Present Azure CLI examples before or alongside PowerShell to avoid implying PowerShell is the primary or preferred method.
- Include Bash shell examples where appropriate, especially for scripting and automation.
- Mention cross-platform alternatives to ARMClient, or clarify its compatibility with non-Windows systems.
- Explicitly state that both Azure CLI and PowerShell are cross-platform, and provide OS-agnostic instructions for installing and using them.
- Ensure all code snippets and instructions are tested and applicable on Linux/macOS as well as Windows.
Create Pull Request