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 moderate Windows bias. Windows-specific tools, commands, and configuration steps are often mentioned before their Linux equivalents, or Linux is only referenced as an afterthought. Several CLI examples and deployment instructions are presented with Windows as the default or primary context, and PowerShell is included as a recommended tool for resource creation. In some sections, Linux-specific instructions are present but less emphasized or appear after Windows instructions. There are also areas where only Windows or Visual Studio workflows are detailed, with less parity for Linux or cross-platform alternatives.
Recommendations:
- Ensure all CLI and deployment examples are provided for both Windows and Linux equally, using cross-platform tools (e.g., Azure CLI) as the default.
- When listing tools or methods (e.g., Visual Studio, PowerShell, Azure CLI), avoid listing Windows-specific options first; instead, present cross-platform options first or in parallel.
- Where PowerShell is mentioned, always include Bash or shell equivalents for Linux users.
- In sections discussing configuration or deployment, provide explicit Linux examples and highlight any differences or required steps for Linux environments.
- Where Visual Studio is referenced, ensure Visual Studio Code (cross-platform) instructions are equally detailed and prominent.
- Review all code snippets and command-line instructions to ensure they are not Windows-centric (e.g., avoid backslashes in paths, use environment-agnostic syntax).
- Add a summary table or section at the start that clearly indicates which instructions apply to Windows, Linux, or both, and link to the relevant sections.
Create pull request