Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias in several ways. PowerShell/Windows examples are presented before Bash/Linux equivalents, with the PowerShell tab listed first in the 'Verify your custom domain' section. The PowerShell example uses 'curl.exe' and the 'PS C:\>' prompt, both of which are Windows-specific tools and conventions. Throughout the document, there is a lack of explicit Linux or cross-platform guidance, and the Azure portal screenshots and instructions do not mention platform-specific alternatives or considerations.
Recommendations
- Present Bash/Linux examples before or alongside PowerShell/Windows examples, or randomize tab order to avoid implicit prioritization.
- Use platform-neutral tools and prompts in examples (e.g., generic 'curl' usage, avoid 'PS C:\>' prompt).
- Explicitly mention that all steps and portal instructions apply equally to Linux, macOS, and Windows, or provide notes where there are differences.
- Include CLI examples using Azure CLI (az) for certificate and managed identity operations, which are cross-platform.
- Add guidance or screenshots for Linux/macOS users where relevant, especially for command-line operations.
Create Pull Request