Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples throughout, but PowerShell is featured equally and sometimes before CLI, and there is a notable focus on PowerShell (a Windows-centric tool). There are no Linux-specific shell examples (e.g., Bash), and references to Windows tools and patterns are present, such as the mention of a Windows-specific quickstart template for installing certificates. The documentation does not mention or demonstrate Linux-native scripting environments or workflows, and the PowerShell examples use Windows-style line continuations and variable syntax.
Recommendations
- Add explicit Bash shell examples alongside Azure CLI, demonstrating Linux-native workflows (e.g., using export for environment variables, Linux-style line continuations, and file paths).
- When referencing quickstart templates or scenarios, provide both Windows and Linux equivalents (e.g., link to a Linux VM certificate install template as well as the Windows one).
- Ensure that CLI examples use syntax and conventions that are platform-neutral or show both Windows and Linux variants where they differ.
- Consider adding a section or callout for Linux users, highlighting any differences or best practices for Linux environments.
- Review the order of examples to avoid always listing PowerShell before CLI, or alternate the order to avoid implicit prioritization of Windows tools.
Create Pull Request