Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates Windows bias primarily through the exclusive use of PowerShell for automation and scripting examples, specifically for rotating the BTP client secret. All provided CLI/script examples use PowerShell and Azure PowerShell modules, with no mention of Bash, Linux shell, or cross-platform alternatives. There is no guidance for Linux users or examples using Azure CLI (az), which is cross-platform. The documentation also references Azure Key Vault and Azure portal workflows, which are accessible from any OS, but the automation focus is Windows-centric.
Recommendations
- Provide equivalent Bash or Azure CLI script examples for Linux/macOS users, especially for secret rotation and connector management.
- Explicitly state cross-platform support for all automation steps, and clarify which tools are required for each OS.
- Add notes or links to documentation for Linux users on installing and using Azure CLI and relevant authentication methods.
- Where possible, use Azure CLI commands in examples, as they are natively cross-platform, or offer both PowerShell and Bash/CLI alternatives side-by-side.
- Review all automation and scripting sections to ensure Linux parity and avoid implying that Windows/PowerShell is the only supported or recommended environment.
Create Pull Request