Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a Windows bias by exclusively providing PowerShell examples for all command-line operations, referencing Windows tools and patterns (e.g., execution policy, PowerShell 7), and omitting equivalent Linux or cross-platform CLI instructions. The use of PowerShell is assumed for all programmatic tasks, with no mention of Bash, Azure CLI, or Linux-native workflows. Windows terminology and concepts (such as NTFS, ACLs, and Key Vault integration for SMB) are foregrounded, while Linux/NFS details are secondary and lack practical example parity.
Recommendations
- Add Azure CLI (az) examples for all endpoint management operations alongside PowerShell, ensuring both Windows and Linux users have clear guidance.
- Include Bash shell script samples for common tasks, such as creating, viewing, editing, and deleting endpoints.
- Explicitly document any Linux prerequisites or differences, such as authentication, agent installation, or file system semantics.
- Where PowerShell-specific instructions are given (e.g., execution policy), provide Linux equivalents or note that these steps are not required on Linux.
- Reference Linux tools and patterns (e.g., curl, jq, bash scripting) where appropriate, especially for programmatic access.
- Ensure screenshots and UI instructions are platform-neutral or clarify any platform-specific behaviors.
- Review terminology to balance Windows-centric concepts (NTFS, ACLs) with Linux/NFS equivalents, and provide links to relevant Linux documentation.
Create Pull Request