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
⚠️
missing_linux_example
Summary:
The documentation provides Bash-based Azure CLI examples, which are generally cross-platform, but consistently uses Windows-style file paths (e.g., C:\temp\) and references to Windows filesystem locations in variable assignments and instructions. There are no explicit Linux or macOS path examples, and the XML file example instructs users to create files in C:\temp, a Windows-specific directory. This may confuse or exclude Linux/macOS users, as no equivalent Linux paths (e.g., /tmp or ~/temp) are shown. No PowerShell-specific commands or Windows-only tools are used, but the path conventions and file location instructions display a subtle Windows-first bias.
Recommendations:
- Provide both Windows and Linux/macOS path examples in all code snippets and instructions (e.g., use $HOME/temp or /tmp for Linux/macOS, and C:\temp for Windows).
- Add a note at the start of the article clarifying that file paths should be adapted to the user's OS, with examples for each.
- When referencing file creation or locations (such as the XML file example), include both Windows and Linux/macOS instructions.
- Consider using environment variables (like $HOME or %USERPROFILE%) in examples to make them more cross-platform.
- Explicitly state that the Bash examples work on both Windows (with WSL or Git Bash) and Linux/macOS, and provide guidance for PowerShell users if relevant.
Create pull request