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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. PowerShell is presented as a primary method alongside Azure CLI and portal, with detailed PowerShell-specific instructions and terminology. There are several references to 'local PowerShell terminal' and Windows-specific tools (e.g., Git Credential Manager dialog, MSBuild, node-gyp errors referencing Windows). There is a lack of explicit Linux/macOS terminal or shell examples, and troubleshooting sections reference Windows-specific errors and build tools before mentioning cross-platform equivalents.
Recommendations:
- Add explicit Linux/macOS terminal instructions and examples, especially where PowerShell is referenced (e.g., 'In a local terminal' instead of 'In a local PowerShell terminal').
- Include Bash or shell command alternatives for PowerShell cmdlets, or clarify which commands are cross-platform.
- When mentioning tools like Git Credential Manager or MSBuild, also mention their Linux/macOS equivalents or note their cross-platform availability.
- In troubleshooting, provide error messages and solutions relevant to Linux/macOS environments (e.g., native module build errors on Linux, authentication dialogs on macOS).
- Ensure that CLI examples are presented before or alongside PowerShell, and avoid assuming Windows as the default environment.
Create pull request