About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a bias toward Windows environments by prioritizing PowerShell-based instructions and tools, referencing Windows-centric patterns, and not providing explicit Linux/macOS guidance or examples. PowerShell is mentioned and exemplified before Azure CLI, and there is no discussion of cross-platform shell usage or Linux-specific considerations. The documentation assumes familiarity with Windows tools and does not address potential differences or requirements for Linux users.
Recommendations:
- Provide explicit Linux/macOS instructions and examples, especially for authentication and environment setup (e.g., clarify that Azure CLI and PowerShell Core are cross-platform, and show usage in bash/zsh).
- When listing tooling (e.g., PowerShell, Azure CLI), present Azure CLI examples first or in parallel, as it is natively cross-platform.
- Include notes or sections on any OS-specific prerequisites, such as package managers for installing Azure CLI or PowerShell on Linux/macOS.
- Where PowerShell cmdlets are referenced, clarify if they require Windows PowerShell or if they work with PowerShell Core on Linux/macOS.
- Add screenshots or terminal output examples from Linux/macOS environments where applicable.
- Explicitly state that all command-line steps can be performed on Linux/macOS, and provide troubleshooting tips for non-Windows users.
Create pull request