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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation shows moderate Windows bias: PowerShell is used as the default code block language even for Linux commands, Windows-specific troubleshooting steps are often more detailed or appear first, and Windows tools/paths are referenced explicitly. Linux guidance is present but sometimes less detailed or lacks parity in example depth and clarity.
Recommendations:
- Use the appropriate code block language for each OS (e.g., 'bash' for Linux shell commands, not 'powershell').
- Ensure Linux and Windows troubleshooting steps are equally detailed and presented in parallel where possible.
- When referencing log file locations or tools, provide both Linux and Windows equivalents together, or alternate which OS is mentioned first.
- Add explicit Linux command examples where only Windows/PowerShell commands are shown, and vice versa.
- Avoid using Windows-centric terminology (e.g., 'deploy the template') without clarifying Linux alternatives or providing cross-platform instructions.
Create pull request