Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation demonstrates a mild Windows bias, primarily in the order and specificity of examples. In sections such as 'Check pip installation', instructions are given for 'Windows or Mac', but Linux is omitted. The initial instructions for checking pip and installing it reference Windows and Mac, but do not provide explicit Linux commands or guidance. Additionally, in the 'Create resource group' section, the tip for setting a default subscription uses a Windows-style command prompt example, and the general flow of the document assumes familiarity with Windows environments. However, most CLI commands are cross-platform, and there are no PowerShell-only or Windows-only tools required.
Recommendations
- Add explicit Linux instructions and examples for pip installation and verification, such as using 'python3 -m pip --version' and package manager commands (e.g., 'sudo apt install python3-pip').
- When referencing command prompts or terminals, clarify that instructions apply to all platforms, and provide Linux shell equivalents where appropriate.
- Ensure that all prerequisite and setup steps include Linux-specific guidance, especially for common developer tasks like installing Python, pip, and Azure CLI.
- Where examples mention 'Windows or Mac', always include Linux for parity.
- Consider reordering examples so that platform-neutral or Linux instructions are presented first, or side-by-side with Windows/Mac.
Create Pull Request