Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Visual Studio Code is listed as a prerequisite without mention of Linux alternatives or editors. File operations (open/save) are described using GUI steps typical of Windows environments. In deployment instructions, PowerShell is presented as an equal option to Bash/CLI, but the PowerShell example is more verbose and detailed, and the instructions reference Windows-style file paths and prompts. There is no mention of Linux-specific editors, file navigation, or alternative workflows. The clean-up section relies on Azure Portal GUI steps, which are platform-neutral but do not mention CLI alternatives that are popular on Linux.
Recommendations
- Include Linux-specific instructions for file operations, such as using nano, vim, or command-line tools to open and save files.
- Mention alternative editors (e.g., Vim, nano, Emacs) in the prerequisites section for Linux users.
- Provide explicit Linux shell commands for downloading and saving the template file (e.g., using curl or wget).
- Ensure CLI examples use Linux-friendly file paths and environment variables, and clarify any differences in shell syntax.
- Add a CLI-based resource group deletion example in the clean-up section.
- Consider reordering examples so that CLI/Bash instructions appear before PowerShell, or present both equally.
Create Pull Request