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 demonstrates a Windows-first bias in the 'Build and run the app locally' section by presenting Windows Command Prompt and PowerShell commands before the Linux/macOS equivalent. The use of 'setx' (a Windows-specific tool) and explicit mention of Windows PowerShell further reinforce this bias. Although Linux/macOS commands are provided, they are listed after the Windows examples, and the command prompt syntax is used for Maven and curl commands, which may be confusing for non-Windows users.
Recommendations:
- Present Linux/macOS and Windows instructions in parallel or in separate, clearly labeled sections to ensure equal visibility.
- Avoid using Windows-specific tools (like 'setx') without providing equivalent Linux/macOS alternatives (e.g., 'export' or instructions for setting persistent environment variables).
- Use neutral shell syntax (e.g., '$' for bash) for cross-platform commands like Maven and curl, or provide both Windows and Linux/macOS command examples.
- Consider starting with Linux/macOS examples or alternating the order in which platforms are presented to avoid implicit prioritization of Windows.
- Add explicit notes or callouts for platform-specific steps to help users quickly find relevant instructions.
Create pull request