Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. Windows-specific tools and workflows (Azure PowerShell, Azure portal screenshots) are presented before or instead of Linux equivalents. PowerShell commands are provided, but there are no Bash or Linux shell examples. Portal instructions and screenshots are Windows-centric, and there is no mention of Linux desktop tools or cross-platform alternatives. There are no explicit Linux command-line examples for tasks like disabling local authentication, nor is there guidance for Linux users on environment setup or SDK usage.
Recommendations
- Add Bash or Linux shell command examples alongside PowerShell, especially for resource creation and configuration tasks.
- Include screenshots or instructions for using the Azure portal from Linux browsers, or clarify that the portal is cross-platform.
- Explicitly mention that the Azure CLI is cross-platform and provide Linux-specific installation or usage notes.
- Where environment variables are set in code samples, show both Windows (setx, PowerShell) and Linux (export) methods.
- Provide parity in SDK usage examples by including code snippets that demonstrate authentication and publishing from Linux environments.
- Reference Linux desktop tools (such as VS Code on Linux) and provide guidance for Linux users where relevant.
Create Pull Request