Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation references both Azure CLI and Azure PowerShell sample scripts, but lists Azure PowerShell (a Windows-centric tool) alongside Azure CLI without providing parity for Linux-native scripting (e.g., Bash, shell scripts). There is a lack of explicit Linux or Bash examples for creating service principals or managing credentials, and the mention of PowerShell scripts may imply a Windows-first approach. The only explicit command-line example is for 'docker login', which is cross-platform, but the sample script links and references favor Windows/PowerShell tools. There are no explicit Linux-specific instructions or examples, nor is there mention of Linux tools or patterns for certificate management beyond a brief mention of 'openssl'.
Recommendations
- Provide explicit Bash/shell script examples for common tasks (e.g., creating service principals, managing credentials) alongside PowerShell examples.
- List Azure CLI (cross-platform) examples before PowerShell to avoid Windows-first ordering.
- Include instructions or tips for Linux users, such as using Bash environment variables, file permissions, and certificate management with Linux tools.
- Add links to Linux-focused sample scripts or repositories, if available.
- Clarify that Azure CLI commands work on both Windows and Linux, and highlight any platform-specific considerations.
Create Pull Request