Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides a critical example for registering the Microsoft.Insights resource provider using PowerShell only, with no equivalent Azure CLI or cross-platform instructions. PowerShell is primarily a Windows tool, and presenting it as the sole method creates friction for Linux/macOS users. Additionally, PowerShell is mentioned before other cross-platform tools in the workspace creation section.
Recommendations
- Add Azure CLI examples for registering the Microsoft.Insights resource provider, as Azure CLI is cross-platform and widely used on Linux/macOS.
- When listing tools for workspace creation, present Azure CLI and Bicep before or alongside PowerShell to avoid Windows-first ordering.
- Include notes or links to platform-agnostic methods wherever possible, especially for automation steps.
- Clarify that PowerShell examples are one option and provide alternatives for non-Windows environments.
Create Pull Request