Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is presented first in the deployment mode example section, with a Windows-style file path (c:\MyTemplates\storage.json) used in the PowerShell example. The CLI example follows, but there is no explicit mention of Linux shell usage, nor are Linux-specific considerations (such as file paths or shell environment) discussed. The 'Next steps' section links to a PowerShell-focused deployment guide before mentioning REST API operations, further reinforcing the Windows-first pattern.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid Windows-first bias.
- Use platform-neutral file paths in examples (e.g., ./MyTemplates/storage.json) or provide both Windows and Linux path formats.
- Explicitly mention that Azure CLI is cross-platform and provide example commands in both Bash and PowerShell where appropriate.
- Include links to Linux-specific deployment guides or documentation alongside PowerShell guides in the 'Next steps' section.
- Add a brief note clarifying that both PowerShell and CLI are available on multiple platforms, and highlight any platform-specific considerations.
Create Pull Request