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
⚠️
missing_linux_example
Summary:
The documentation generally aims for cross-platform parity, but there are subtle signs of Windows bias. Command-line examples are consistently split between Bash and Cmd, but Windows (Cmd) examples are always presented alongside or immediately after Bash, sometimes with more detailed context. There are no PowerShell-specific examples, but the presence of Windows command prompt (Cmd) examples throughout, and the explicit mention of 'command prompt' in getting started sections, may suggest a Windows-first mindset. There are no Linux-specific troubleshooting or environment notes, and some sections (such as environment variable configuration) assume familiarity with Windows conventions. No Linux-specific tools or shell environments (e.g., zsh, fish) are mentioned, and there are no explicit Linux troubleshooting steps or caveats.
Recommendations:
- Ensure that Bash examples are always presented first, and clarify that Bash commands work on Linux, macOS, and Windows (with WSL or Git Bash).
- Add explicit notes or sections for Linux users, such as common locations for JAVA_HOME, shell profile configuration, or troubleshooting tips for Linux environments.
- Where 'command prompt' is mentioned, also mention 'terminal' or 'shell' to be inclusive of Linux/macOS users.
- Include Linux-specific troubleshooting steps or caveats where relevant (e.g., file permissions, case sensitivity, environment variable export syntax).
- Consider referencing cross-platform shells (e.g., zsh, fish) or tools (e.g., SDKMAN for Java version management) where appropriate.
- Review all examples and ensure parity in detail and context between Bash and Cmd sections.
Create pull request