Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation provides extensive PowerShell examples and references the PowerShell SDK, which is primarily a Windows-centric tool. PowerShell is presented as a first-class language alongside C#, JavaScript, Python, and Java, but there are no equivalent Linux shell (e.g., Bash) examples or references to Linux-native tools. The orchestration client API support for starting orchestrations with a specific version is explicitly unavailable for JavaScript, Python, and PowerShell, but the PowerShell section does not mention any Linux alternatives. The documentation does not mention or provide examples for Linux-specific deployment, configuration, or troubleshooting patterns, and the use of PowerShell as the only shell scripting example reinforces a Windows-first approach.
Recommendations
- Add Bash or other Linux shell examples for orchestration triggers and activity invocation, especially in sections where PowerShell is used.
- Reference Linux-native tools and scripting environments where appropriate, or clarify cross-platform compatibility for PowerShell Core.
- Include guidance for Linux deployment scenarios, such as using Azure Functions on Linux hosts, and troubleshooting with Linux tools.
- Explicitly mention whether PowerShell examples are compatible with PowerShell Core on Linux, or provide alternatives if not.
- Balance the language tabs by including Linux shell scripting as an option, or clarify that PowerShell is cross-platform if that is the intent.
- Where orchestration client API features are unavailable for certain languages, suggest Linux-friendly workarounds or note platform parity plans.