Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page for the Service Fabric application lifecycle heavily references PowerShell cmdlets and .NET APIs for operational tasks (deploy, upgrade, remove, maintain), with only passing mention of REST APIs and no explicit Linux/CLI examples. There is no coverage of Linux-native tools or Service Fabric CLI (sfctl) usage in the main procedural steps, despite a link to CLI docs at the top. This creates friction for Linux/macOS users, who are likely to use sfctl or Azure CLI rather than PowerShell.
Recommendations
- Add explicit sfctl (Service Fabric CLI) command examples alongside PowerShell cmdlets for all operational steps (deploy, upgrade, remove, maintain, etc.).
- Where PowerShell is mentioned, clarify if/when it is available cross-platform (e.g., via PowerShell Core on Linux/macOS), or provide alternative commands.
- In procedural lists, present REST API, sfctl, and PowerShell options together, or group by platform/tool.
- Add a short section or callout for Linux/macOS users, linking to relevant CLI documentation and noting any platform-specific considerations.
- Ensure that all code snippets and automation examples have Linux equivalents (e.g., bash/sfctl/az CLI).
Create Pull Request