Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation generally provides parity for Linux/macOS and Windows users, with most commands shown in a cross-platform manner and explicit tabs for Linux/macOS and Windows. However, there are some subtle signs of Windows bias: Windows command line options (Cmd, PowerShell) are often shown before Linux/macOS equivalents, and PowerShell is included as a primary programming language pivot, which may not be as relevant for Linux/macOS users. In the Python virtual environment section, Windows bash is shown before Windows Cmd, and Linux/macOS is listed first, which is good. In the function invocation section, bash is shown first, but Windows Cmd and PowerShell are given detailed attention. Overall, Linux/macOS users can complete all tasks, but Windows tools and patterns are slightly more prominent.
Recommendations
- Ensure Linux/macOS examples are always presented first or equally alongside Windows examples.
- Where PowerShell is used, clarify its cross-platform availability or provide bash/zsh equivalents if relevant.
- Explicitly mention that all CLI commands work on Linux/macOS unless otherwise noted.
- Consider adding a note about using Azure Functions Core Tools and azd on Linux/macOS, including any platform-specific caveats.
- Review the order of tabs and pivots to avoid implicit prioritization of Windows tools.