Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation demonstrates a strong bias toward Windows and PowerShell environments. All command-line examples for creating and managing connections use PowerShell cmdlets, with no equivalent CLI or Bash/Linux shell examples. The documentation refers to 'Windows PowerShell' explicitly and does not mention cross-platform alternatives like Azure CLI or REST API for Linux/macOS users. The internal cmdlets and graphical runbook sections also assume a Windows-centric workflow. While Python examples are provided, they are specific to Azure Automation runbooks and do not address general Linux shell usage.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell cmdlet operations (e.g., creating, retrieving, and deleting connections).
- Include Bash/Linux shell examples where applicable, especially for connection management tasks.
- When introducing tools or workflows, mention cross-platform options (e.g., Azure CLI, REST API) alongside or before Windows/PowerShell tools.
- Avoid using 'Windows PowerShell' as the default term; use 'PowerShell' and clarify when examples are cross-platform.
- Provide explicit guidance for Linux/macOS users on how to perform the same tasks, including any platform-specific prerequisites or differences.
- Ensure that all code tabs or sections (PowerShell, CLI, Python) are equally represented and easy to find.
Create Pull Request