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 exhibits mild Windows bias. While it mentions Bash alongside cmd and PowerShell, the phrasing consistently lists Windows shells first, and there are no explicit Linux/macOS-specific instructions or troubleshooting notes. All command-line examples use the generic 'dotnet' CLI, which is cross-platform, but there are no Linux/macOS terminal screenshots, nor are there any notes about platform-specific differences (e.g., file paths, environment variables, or permissions). The documentation assumes familiarity with Windows-centric tools and patterns, and does not address Linux-specific considerations.
Recommendations:
- Alternate the order of shell mentions (e.g., 'Bash, PowerShell, or cmd') or explicitly state that all commands work on Windows, Linux, and macOS.
- Include at least one terminal screenshot or code block showing commands run in a Linux/macOS terminal.
- Add a note clarifying that the .NET CLI and all code samples are cross-platform, and provide links to Linux/macOS installation instructions for .NET if not already present.
- Mention any known platform-specific issues (e.g., file permissions, path separators) if applicable.
- Consider adding a troubleshooting section for common Linux/macOS issues (e.g., 'dotnet' not found, permissions).
Create pull request