Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page exhibits a strong Windows bias, primarily through exclusive use of PowerShell cmdlets for all command-line examples and references, with no mention of Linux/macOS equivalents or cross-platform CLI tools. Windows-centric tools and workflows (PowerShell, Visual Studio) are referenced throughout, and there is a lack of guidance for Linux users on how to perform the same tasks. The page assumes the reader is using Windows environments and does not provide parity for Linux/macOS users.
Recommendations
- Add equivalent examples using Azure CLI (az sf) or REST API for all PowerShell cmdlets, especially for service creation, upgrades, and parameter changes.
- Explicitly mention cross-platform alternatives where available, and clarify which features are available on Linux clusters.
- Include bash or shell script examples for Linux users, and document any differences in workflow or tooling.
- Reference Linux/macOS compatible tools (such as Service Fabric CLI or SDK) alongside Windows tools like PowerShell and Visual Studio.
- Reorganize examples so that Windows and Linux approaches are presented side-by-side, or clarify platform-specific instructions.
Create Pull Request