Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily biased towards Windows, with all onboarding scripts and examples provided exclusively in PowerShell (.ps1) format. Prerequisites use Windows-specific tools (winget), and there are no Bash, shell, or Linux/macOS instructions or script equivalents. All example commands and instructions assume a Windows environment and PowerShell terminal, creating friction for Linux/macOS users.
Recommendations
- Provide equivalent Bash/shell scripts for infra and CM onboarding, or document how to run the PowerShell scripts on Linux/macOS (e.g., via pwsh).
- List Linux/macOS installation commands for prerequisites (e.g., use apt, brew, or direct downloads for Azure CLI and kubectl).
- Include explicit notes or sections for Linux/macOS users, clarifying any differences in script execution, file paths, or environment setup.
- Avoid using Windows-specific tools like winget in prerequisites, or provide alternatives for other platforms.
- Present cross-platform examples side-by-side or indicate which commands/scripts are platform-specific.
Create Pull Request