Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation demonstrates a moderate Windows bias. PowerShell is featured as a primary automation example, and references to installing and using PowerShell locally are prominent in the prerequisites. The PowerShell tab is presented before the CLI tab in code examples, and the prerequisites section gives detailed instructions for PowerShell setup, including module installation and account connection, which are Windows-centric. While Azure CLI examples are provided (which are cross-platform), the documentation's structure and language favor Windows users and tools.
Recommendations
- Present CLI examples before PowerShell examples to emphasize cross-platform parity.
- Clarify that Azure CLI works natively on Linux and macOS, and provide explicit instructions for those platforms in the prerequisites.
- Reduce the prominence of PowerShell-specific instructions, or move them to a dedicated Windows section.
- Add notes or links for Linux/macOS users regarding installation and usage of Azure CLI and any platform-specific considerations.
- Ensure that references to tools and commands are balanced between Windows and Linux/macOS environments.
Create Pull Request