Document Details
Runbooks
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily focused on PowerShell-based troubleshooting and examples, with nearly all code samples, cmdlet references, and module instructions centered around PowerShell and Windows-centric tools (e.g., PowerShell ISE, Az.Automation, AzureRM). There is little to no mention of Linux/macOS-specific workflows, shell environments, or cross-platform scripting approaches. Linux/macOS users are left to infer how to adapt the guidance, and there are no Bash, Python, or CLI examples for common troubleshooting scenarios.
Recommendations
- Add equivalent troubleshooting steps and code samples for Bash, Azure CLI, and Python runbooks where applicable.
- Explicitly mention cross-platform compatibility for PowerShell Core (pwsh) and clarify any Windows-only limitations.
- Provide guidance for Linux/macOS users on how to author, test, and debug runbooks locally (e.g., using VS Code on Linux, running scripts with pwsh).
- Include links to Azure CLI and REST API documentation for tasks that can be performed outside PowerShell.
- Reorder examples so that cross-platform or neutral approaches (e.g., Azure CLI, REST API) are presented before or alongside Windows/PowerShell-specific methods.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-13 06:17 | #107 | completed |
Biased
|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
Biased
|
| 2026-01-11 00:00 | #95 | cancelled |
 Clean
|
| 2026-01-10 00:00 | #92 | completed |
Clean
|
| 2026-01-09 00:00 | #87 | cancelled |
Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|