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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a mild Windows bias. Windows tools and patterns (e.g., cmd.exe, drive letters, backslashes in paths) are often mentioned first or exclusively. Some examples and directory postfixes use Windows conventions (e.g., backslashes), and Linux equivalents are sometimes less detailed or presented second. There is also a lack of parity in some explanations, such as the use of drive letters for Windows mounts and the absence of explicit Linux mount path examples.
Recommendations:
- Present Linux and Windows examples in parallel, with equal detail and prominence.
- Avoid using Windows path conventions (e.g., backslashes, drive letters) as the default; provide both Windows and Linux path formats in tables and examples.
- When referencing tools (e.g., cmd.exe), always include the Linux equivalent (e.g., /bin/sh) with equal detail.
- For environment variables or features that differ by OS (e.g., AZ_BATCH_APP_PACKAGE naming), provide clear, side-by-side examples for both platforms.
- Where possible, use OS-agnostic language or clarify when something is OS-specific.
- Ensure that all instructions, especially those involving directory structures or shell commands, have Linux equivalents and are not Windows-centric.
Create pull request