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 biases. Windows command-line examples (Cmd) are consistently presented alongside Bash, but Cmd is always listed second, which is a minor 'windows_first' bias. There is a heavier focus on Windows-specific terminology (e.g., 'command prompt') and some references to Windows in tables and explanations. However, Linux is also covered in most places, and Bash examples are provided. There are no explicit PowerShell examples, but the presence of Cmd tabs and references to 'command prompt' may be interpreted as a Windows-centric approach. No Linux-specific tools or troubleshooting are highlighted, and there are no explicit Linux-only examples or guidance, which could be seen as a 'missing_linux_example' bias.
Recommendations:
- Ensure that all command-line examples are presented with equal prominence for both Bash (Linux/macOS) and Cmd (Windows), and consider including PowerShell where appropriate.
- Avoid using Windows-centric terminology like 'command prompt' without also mentioning 'terminal' or 'shell' for Linux/macOS users.
- Where OS-specific instructions are necessary, provide clear, parallel guidance for both Windows and Linux, including troubleshooting steps.
- Highlight any Linux/macOS-specific considerations, such as file permissions, case sensitivity, or environment variable differences.
- Consider including a section or appendix specifically addressing Linux/macOS development environments, common issues, and best practices.
- When referencing supported Java versions or runtime behaviors, ensure that Linux and Windows are given equal detail and placement in tables and explanations.
Create pull request