21
Pages Scanned
4
Pages Flagged
21
Changed Pages
19.0%
% Pages Flagged
Scan Information
Started At: 2026-01-25 00:00:09
Finished At: 2026-02-10 18:00:39
Status: completed
Target Repo: Azure Management
Current Phase: discovery
Files Queued: 21
Files Completed: 21
Problematic Pages
4 issues found
Azure Arc
Manage and maintain the Azure Connected Machine agent
...s/blob/main/articles/azure-arc/servers/manage-agent.md
Medium Priority
View Details →
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides comprehensive guidance for both Windows and Linux users for most lifecycle tasks (install, upgrade, uninstall, proxy configuration) using clear tabbed sections. However, there is a notable bias in the 'Remove stale server resources' section, which only provides a PowerShell script and instructions for Windows/PowerShell users, with no equivalent Bash or cross-platform script for Linux/macOS users. Additionally, some sections (such as manual upgrade/uninstall) provide more detailed, step-by-step instructions for Windows (including Control Panel, Group Policy, and Msiexec usage), whereas Linux sections are more concise. Windows tools and patterns (e.g., Group Policy, WSUS, Configuration Manager) are described in detail, while Linux equivalents (such as automation via Ansible, systemd, or shell scripting) are not mentioned. In some cases, Windows instructions or tools are presented first.
Recommendations
- Provide a Bash or cross-platform (e.g., Azure CLI) script for identifying and deleting stale/disconnected Arc-enabled servers, or at least reference how Linux/macOS users can perform this task.
- Where possible, balance the level of detail in Linux sections to match Windows (e.g., include common automation or troubleshooting patterns for Linux environments).
- When describing automation or update infrastructure (e.g., Group Policy, WSUS), consider mentioning Linux equivalents (such as Ansible, cron jobs, or package manager hooks) or explicitly state if there are no direct equivalents.
- In sections where Windows instructions are presented first, consider alternating or clarifying that both platforms are equally supported.
- For PowerShell-heavy examples, provide Azure CLI or REST API equivalents where possible, as these are cross-platform.
Create Pull Request
Azure Arc
Enable VM Extensions Using Azure Resource Manager Template
...les/azure-arc/servers/manage-vm-extensions-template.md
Medium Priority
View Details →
Detected Bias Types
powershell_heavy
missing_linux_example
windows_first
Summary
The documentation provides ARM template examples for both Linux and Windows VM extensions, but all deployment instructions and command-line examples use Azure PowerShell exclusively, with no Azure CLI or Bash examples. The deployment steps and verification instructions are PowerShell-centric, which may create friction for Linux/macOS users who prefer Bash or Azure CLI. Additionally, PowerShell commands are presented first and exclusively in all deployment sections.
Recommendations
- Add equivalent Azure CLI deployment commands for ARM template deployments, especially for Linux/macOS users.
- Include Bash script examples for template deployment where appropriate.
- Explicitly mention that both Azure PowerShell and Azure CLI can be used for deployments, and link to CLI documentation.
- Consider presenting both PowerShell and CLI examples side-by-side, or alternate which is shown first.
- Clarify any platform-specific requirements for the deployment tools (e.g., PowerShell Core vs. Windows PowerShell).
Azure Arc
What's new with Azure Connected Machine agent
...main/articles/azure-arc/servers/agent-release-notes.md
Low Priority
View Details →
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The release notes for Azure Connected Machine agent generally provide parity between Windows and Linux, with features and fixes listed for both platforms. However, there is a mild Windows bias: Windows download links and version numbers are consistently listed before Linux, installer troubleshooting and instructions reference Windows tools (msiexec, PowerShell, Command Prompt) exclusively, and some improvements (e.g., ExtensionCleanup.ps1, GUI accessibility) are Windows-only with no Linux equivalents or alternative instructions. Linux-specific issues and fixes are present, but Windows patterns and tools are mentioned first and more often.
Recommendations
- Where installer troubleshooting is discussed, add equivalent Linux instructions (e.g., using rpm, dpkg, systemctl) for parity.
- When referencing scripts or tools (e.g., ExtensionCleanup.ps1), clarify if there are Linux alternatives or note that the feature is Windows-only.
- Alternate the order of Windows and Linux download links and version numbers to avoid implicit prioritization.
- Include Linux/macOS command-line examples or troubleshooting steps alongside Windows/PowerShell examples when relevant.
Container Registry
Deploy the Connected Registry Arc Extension
...iner-registry/quickstart-connected-registry-arc-cli.md
Low Priority
View Details →
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Bash and PowerShell examples for generating the protected settings JSON file, but the Bash example is shown first. The PowerShell example is included, but it is not strictly Windows-specific (PowerShell Core is cross-platform). All other commands use Azure CLI and kubectl, which are cross-platform tools. No Windows-only tools or patterns are used, and Linux users can follow the guide without friction.
Recommendations
- Clarify that the PowerShell example works on both Windows PowerShell and PowerShell Core (which is available on Linux/macOS).
- Consider labeling the PowerShell tab as 'PowerShell (Windows/macOS/Linux)' to avoid implying it's Windows-only.
- Ensure any future examples that use OS-specific shell features are mirrored for both Bash and PowerShell, and clarify platform compatibility.
- If possible, add a note that Bash is available on Windows via WSL or Git Bash, and PowerShell is available on Linux/macOS.