Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates several forms of Windows bias. Windows tools and patterns (such as Cloud Shell and file upload via GUI) are mentioned first or exclusively, with limited or no Linux-specific guidance. PowerShell is referenced as an alternative shell, but the main instructions and troubleshooting tips focus on Windows environments. There are missing Linux-specific examples for file upload and shell escaping, and the documentation does not provide parity for Linux command-line workflows or tools.
Recommendations
- Add explicit instructions and screenshots for uploading files to Cloud Shell from Linux environments, including command-line methods (e.g., using SCP, wget, or Azure CLI storage commands).
- Provide Linux-specific examples for shell escaping, especially for inline JSON and special characters, with clear Bash and Zsh syntax.
- Mention and demonstrate Linux-native editors (e.g., nano, vim) for editing model files, not just generic 'code editor'.
- Clarify that Azure CLI is cross-platform and provide troubleshooting tips for common Linux issues (e.g., file permissions, path formats).
- Balance references to PowerShell and Bash, and ensure that Bash/Linux instructions are given equal prominence and detail.
- Include a section or callout for Linux users, summarizing any differences or additional steps they may encounter.
Create Pull Request