Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a notable Windows bias, particularly in the CI/CD best practices section. PowerShell is recommended exclusively for pre- and post-deployment scripting, with no mention of Bash, shell scripts, or cross-platform alternatives. The provided script is a PowerShell (.ps1) file, and warnings focus on PowerShell Core usage, which, while cross-platform, is still less common on Linux/macOS. There are no Linux/macOS-specific examples or guidance, and Windows-centric tools and patterns are referenced before any alternatives.
Recommendations
- Provide equivalent Bash or shell script examples for pre- and post-deployment tasks.
- Explicitly mention that PowerShell Core is available on Linux/macOS and provide installation instructions or links.
- Include notes or examples for running CI/CD scripts in Linux/macOS environments, such as using Bash in Azure Pipelines.
- Clarify that users can choose between PowerShell and Bash depending on their platform and provide parity in documentation.
- List cross-platform prerequisites and troubleshooting steps for both Windows and Linux/macOS users.
Create Pull Request