Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation generally presents Windows examples and terminology before Linux equivalents, and uses PowerShell for Windows command examples while using Bash for Linux. In several sections, Windows instructions are listed first, and Windows-specific extension names are mentioned before Linux ones. However, Linux examples are present and reasonably complete, and the CLI tool (azcmagent) is cross-platform.
Recommendations
- Alternate the order of Windows and Linux examples throughout the documentation, or present them side-by-side.
- Explicitly state that all azcmagent commands work on both platforms, and clarify any platform-specific differences.
- Provide more parity in extension naming and descriptions, ensuring Linux and Windows extensions are equally highlighted.
- Where PowerShell is used for Windows, consider mentioning that Bash or other shells can be used on Windows (e.g., via WSL), to promote cross-platform usage.
- Add a summary table of common extension names for both Windows and Linux to help users quickly identify equivalents.
Create Pull Request