Document Details
How To Observability
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias in the deployment instructions for the sample scenario. Only PowerShell is mentioned and used for deployment, with no Linux/macOS shell or Bash alternatives provided. The instructions explicitly tell users to open a PowerShell console and run a PowerShell script, without acknowledging or supporting Linux-native workflows. This creates friction for Linux/macOS users who may not have PowerShell installed or prefer Bash. The rest of the documentation is platform-neutral, but the critical deployment step is Windows-centric.
Recommendations
- Provide equivalent Bash shell instructions for Linux/macOS users, such as a .sh deployment script.
- Explicitly mention Linux/macOS compatibility and required tools (e.g., Azure CLI, Bash, PowerShell Core).
- If PowerShell is required, clarify that PowerShell Core is cross-platform and provide installation instructions for Linux/macOS.
- Offer troubleshooting tips for Linux/macOS users who may encounter issues running PowerShell scripts.
- Consider restructuring deployment instructions to present Bash and PowerShell options side-by-side.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-10 00:00 | #92 | completed |
 Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|