Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily biased towards Windows and PowerShell usage. All command-line examples use Azure PowerShell cmdlets, and file paths are shown in Windows format (e.g., C:\Users\SampleUser\Downloads) before mentioning Linux/Cloud Shell equivalents. There are no examples using Azure CLI, Bash, or native Linux tools, and the workflow assumes familiarity with Windows conventions and PowerShell scripting.
Recommendations
- Provide equivalent Azure CLI (az) command examples for each PowerShell command, as Azure CLI is cross-platform and commonly used on Linux and macOS.
- Include Bash shell script examples and Linux file path conventions (e.g., /home/user/Downloads) alongside or before Windows paths.
- Clearly indicate when a command or feature is only available in PowerShell, and suggest alternatives for Linux users where possible.
- Add a section or callout at the beginning clarifying that all steps can be performed from Azure Cloud Shell (which supports both Bash and PowerShell), and provide explicit instructions for both environments.
- Where file downloads or manipulations are discussed, show both Windows and Linux/MacOS methods for accessing or handling those files.
- Avoid using Windows-specific terminology or tools (such as referencing only PowerShell or C:\ paths) without also providing Linux/MacOS equivalents.
Create Pull Request