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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by prioritizing Windows tools and workflows (Visual Studio, PowerShell), providing explicit instructions and screenshots for Visual Studio (a Windows-centric IDE), and using PowerShell for resource cleanup without offering equivalent Linux/bash alternatives. While the .NET CLI is mentioned and bash is referenced in passing, Linux-specific guidance, troubleshooting, or examples are missing, especially for resource cleanup and IDE/editor usage.
Recommendations:
- Provide explicit Linux/bash alternatives for all command-line instructions, especially for resource cleanup (e.g., show az CLI or bash commands alongside PowerShell).
- Include screenshots and instructions for cross-platform editors like Visual Studio Code, not just Visual Studio 2022.
- When referencing opening the project, include Linux-friendly editors (e.g., code . for VS Code, or instructions for JetBrains Rider).
- In the prerequisites, clarify that .NET Core/.NET 6+ is cross-platform and provide installation links for Linux and macOS, not just .NET Framework (which is Windows-only).
- For package management, mention that the dotnet CLI is available on Linux and macOS, and provide troubleshooting steps relevant to those platforms.
- Where PowerShell is used (e.g., resource cleanup), provide an equivalent az CLI command (e.g., az group delete) and show both side-by-side.
- Ensure that all instructions, especially those involving file paths, environment variables, or shell commands, are cross-platform or have platform-specific notes.
Create pull request