Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation page demonstrates a Windows bias by exclusively providing PowerShell examples for endpoint management, referencing Windows tools and patterns (e.g., PowerShell, execution policy, resource naming conventions tied to Windows), and omitting equivalent Linux CLI or scripting examples (such as Azure CLI, Bash, or REST API usage). Windows/PowerShell instructions are presented as the only programmatic option, with no mention of Linux-native workflows or tools. Additionally, the narrative and examples often assume a Windows-centric environment, such as referencing NTFS file properties and Windows authentication concepts before Linux/NFS equivalents.
Recommendations
- Add Azure CLI examples for all endpoint management tasks, including creation, viewing, editing, and deletion, to provide parity for Linux users.
- Include Bash scripting examples and instructions for using the REST API directly, which are common on Linux systems.
- Explicitly mention Linux support and workflows in introductory sections, clarifying that all operations can be performed from Linux environments.
- Reference Linux-native authentication and file system concepts alongside Windows/NTFS, ensuring equal coverage and order.
- Review and update screenshots and UI references to ensure they do not assume a Windows environment (e.g., avoid showing only Windows-style paths or tools).
- Where PowerShell is referenced, provide equivalent commands for Bash/Azure CLI, and clarify cross-platform compatibility.
Create Pull Request