Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most steps, but PowerShell is featured as a first-class option throughout, including module installation and resource management. Azure CLI is cross-platform, but PowerShell is primarily used on Windows, and its inclusion as a main tab may create friction for Linux/macOS users. In several sections, PowerShell examples are shown before or alongside CLI, and there are no Linux/macOS-specific notes or parity checks. However, all critical tasks can be completed with Azure CLI, which is cross-platform.
Recommendations
- Consider making Azure CLI the default or primary example, as it is cross-platform and more widely used by Linux/macOS users.
- Add explicit notes clarifying that Azure PowerShell is primarily for Windows users, and recommend Azure CLI for Linux/macOS.
- Ensure that all PowerShell instructions are matched with Azure CLI equivalents, and avoid presenting PowerShell as the first or preferred option.
- If possible, add a 'bash' or 'Linux/macOS' tab for any steps where CLI usage may differ (e.g., environment variable syntax).
- Review for any subtle assumptions (e.g., use of Windows-style variables or paths) and clarify for cross-platform compatibility.
Create Pull Request