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
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation generally aims for cross-platform parity, but there are subtle signs of Windows bias. Windows command-line tools (cmd, PowerShell) are mentioned alongside or before Linux equivalents, and some instructions or examples reference Windows-specific tools or patterns. The requirement for Azure PowerShell or Azure CLI is presented without noting Linux-specific package managers or shell environments. The cURL examples do include both Bash and Windows cmd, but Windows is often mentioned first or with extra detail. Some references (such as func.exe) use Windows-style naming. There is also a dedicated PowerShell programming language pivot, which may reinforce a Windows-centric view.
Recommendations:
- Ensure all command-line examples are presented in both Bash (Linux/macOS) and Windows cmd/PowerShell, and alternate the order in which they are shown.
- Avoid using Windows-specific executable names (like func.exe) in generic instructions; use 'func' unless specifically discussing Windows.
- When referencing required tools (Azure CLI, PowerShell), clarify that both are cross-platform and provide Linux/macOS installation links or notes.
- Explicitly mention Linux/macOS where appropriate, especially when discussing terminals, shells, or environment setup.
- Consider adding a Linux/macOS-specific troubleshooting or tips section, similar to the PowerShell pivot.
- Review for subtle language that assumes a Windows environment (e.g., 'command prompt'), and use more neutral terms like 'terminal'.
Create pull request