Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides troubleshooting guidance for Python function apps in Azure Functions, which run exclusively on Linux at runtime. However, several sections present Windows/PowerShell commands before their Linux equivalents, and some examples are Windows-centric or lack parity in detail for Linux/macOS users. For instance, PowerShell commands are shown first for checking Python bitness, and in some cases, Windows-specific tools (like 'py') are referenced before 'python3'. Additionally, some command examples (such as deleting directories) list Bash, PowerShell, and Cmd, but Bash is not always shown first. There are also references to generating requirements.txt from Windows/macOS, but mitigation steps are generic and do not provide Linux-specific guidance.
Recommendations
- Present Linux/macOS examples before Windows/PowerShell equivalents, especially since Azure Functions Python runs on Linux.
- Ensure all command examples have clear, detailed Linux/macOS instructions, not just Windows/PowerShell.
- Where Windows-specific tools (e.g., 'py') are referenced, clarify the Linux/macOS equivalent ('python3') and provide parity in explanation.
- Highlight Linux/macOS best practices for requirements.txt generation and deployment, given the runtime environment.
- Review all troubleshooting steps to ensure Linux/macOS users are not left with ambiguous or less detailed guidance.