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
Summary:
The documentation demonstrates mild Windows bias by referencing Windows command shells and tools before or in preference to Linux equivalents. For example, it mentions using Windows cmd.exe as an alternative to Bash, and in several places, it provides Windows-specific instructions (such as using 'set' instead of 'export') before or alongside Linux commands. Additionally, the Java quickstart uses a Windows-style 'cmd' code block for directory creation, even though the rest of the instructions are cross-platform.
Recommendations:
- Present Linux and Windows command instructions in parallel, using tabbed or side-by-side formatting, rather than mentioning Windows as an alternative to Bash.
- When referencing environment variable setting (e.g., 'export' vs 'set'), provide both commands explicitly in a tabbed or clearly separated format, rather than as a parenthetical note.
- For directory creation and navigation, use cross-platform commands (e.g., 'mkdir', 'cd') in a neutral shell format, or provide both Bash and cmd/PowerShell equivalents.
- Avoid using Windows-specific code block annotations (e.g., 'cmd') unless absolutely necessary; prefer 'bash' or a neutral format.
- Ensure that any references to tools or shells do not assume Windows as the default or primary environment.
Create pull request