Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. PowerShell-specific syntax and escape characters are featured in all command examples, with explanations tailored to PowerShell users. Linux/Bash alternatives are mentioned only as side notes, and no explicit Bash/Linux command examples are provided. The prerequisites and instructions assume familiarity with Windows tools and patterns, such as Visual Studio Code and PowerShell, while Linux/macOS users are left to infer necessary adjustments.
Recommendations
- Provide explicit Bash/Linux command examples alongside PowerShell examples, especially for az rest commands and file referencing.
- List Linux/macOS prerequisites (e.g., native Bash, Terminal, alternative editors) equally with Windows prerequisites.
- Clarify escape character usage for both PowerShell and Bash in each example, and show the correct syntax for each platform.
- Avoid assuming Visual Studio Code as the default terminal/editor; mention alternatives for Linux/macOS.
- Present examples for both platforms in parallel, or alternate which platform is shown first.
Create Pull Request