Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates mild Windows bias in the 'Build and run the app' section, where Windows command prompt and PowerShell instructions are listed before Linux/macOS equivalents. PowerShell and Windows-specific commands are explicitly called out, while Linux/macOS instructions are present but appear after Windows examples. No Linux-specific tools or patterns are discussed elsewhere, but the .NET CLI commands and code samples themselves are cross-platform.
Recommendations
- Present environment variable instructions in a platform-neutral order (e.g., group Windows, macOS, and Linux together or list Linux/macOS first in some cases).
- Explicitly state that all .NET CLI commands and code samples work on Windows, Linux, and macOS.
- Consider providing more parity in troubleshooting or configuration steps for Linux/macOS (e.g., mention common shell environments, permissions, or differences in environment variable persistence).
- Avoid using terms like 'If you use Windows...' first; instead, use 'On Windows...', 'On macOS...', 'On Linux...' in parallel bullet points.
- Add a note clarifying that Azure App Configuration and Azure OpenAI SDKs are supported cross-platform.
Create Pull Request