Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying and managing Azure Front Door resources. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and screenshots exclusively show PowerShell output. There are no explicit Linux shell examples (e.g., Bash), nor is there mention of Linux-specific tooling or workflows. The documentation assumes familiarity with PowerShell and does not clarify cross-platform usage for CLI or PowerShell. This may unintentionally prioritize Windows users and workflows.
Recommendations
- Add explicit Bash/Linux shell examples alongside Azure CLI commands, clarifying that Azure CLI works natively on Linux/macOS.
- Include screenshots of CLI output in addition to PowerShell output, or use CLI output as the primary example.
- Clarify that Azure CLI is cross-platform and can be used on Windows, Linux, and macOS, while PowerShell is primarily Windows-focused (though available cross-platform).
- Instruct users on how to install and use Azure CLI on Linux/macOS, and provide links to relevant installation guides.
- Avoid using PowerShell output as the sole visual example; balance with CLI or portal screenshots.
- Consider a 'Platform considerations' section to highlight any differences or additional steps for Linux/macOS users.
Create Pull Request