Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Summary
The documentation provides release notes for both Windows and Linux versions of the Azure Connected Machine agent, with parity in most features and fixes. However, Windows download links and version numbers are consistently listed first. Windows-specific tools (MSI installer, PowerShell, Command Prompt) are referenced in installation instructions and troubleshooting, while Linux equivalents are not mentioned. Some improvements reference Windows scripts (e.g., ExtensionCleanup.ps1) and MSI signature verification, but Linux-specific tools are not similarly highlighted. There are occasional Windows-only or Linux-only fixes, but these are clearly marked.
Recommendations
- Alternate the order of Windows and Linux download links and version numbers to avoid implicit prioritization.
- Include Linux installation troubleshooting tips (e.g., using sudo, package managers) alongside Windows installer guidance.
- When referencing Windows tools/scripts (e.g., PowerShell, MSI), provide Linux equivalents (e.g., Bash scripts, RPM/DEB commands) where relevant.
- Ensure that improvements or bug fixes referencing Windows tools/scripts are matched with Linux equivalents if applicable.