About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
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