Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides step-by-step instructions and code samples for Azure portal, Azure CLI, Azure PowerShell, and ARM templates. While both CLI and PowerShell examples are present, PowerShell is featured as a first-class method throughout, with detailed examples and references. PowerShell is a Windows-centric tool, and its prominence may indicate a Windows bias. There are no explicit Linux shell (bash) or scripting examples, nor any mention of Linux-specific tools or patterns. CLI examples are present, but PowerShell is given equal or greater emphasis, and is listed before CLI in some sections.
Recommendations
- Add explicit bash shell examples for all CLI commands, showing usage in a typical Linux environment (e.g., with environment variables, piping, etc.).
- Clarify that Azure CLI is fully cross-platform and can be used on Linux, macOS, and Windows.
- Consider listing CLI examples before PowerShell, as CLI is the most cross-platform automation tool.
- Mention Linux-native automation options (e.g., scripting with bash, using curl for REST API calls) where appropriate.
- Add notes or links for Linux users on installing and using Azure CLI and ARM templates.
- Review screenshots and instructions for portal usage to ensure they do not assume Windows-only conventions.
Create Pull Request