About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation is heavily biased toward Windows environments. All examples and instructions assume the use of Windows tools (icacls, Windows File Explorer, net use), require a Windows client, and reference PowerShell cmdlets. There are no Linux or cross-platform examples, nor any mention of how to manage permissions from non-Windows systems. The documentation also assumes Active Directory integration in a Windows context and does not address Linux SMB clients or NFS scenarios.
Recommendations:
- Add instructions and examples for configuring file share permissions from Linux clients, including mounting Azure Files over SMB using Linux tools (e.g., mount.cifs) and managing permissions with setfacl or equivalent.
- Clarify whether Windows ACLs can be managed from non-Windows clients, and if not, explicitly state this limitation.
- If Azure Files does not support Linux ACLs or NFS permissions, mention this clearly and provide guidance for Linux/NFS users.
- Include parity in documentation structure: present Linux (and macOS, if supported) options alongside Windows, not just as an afterthought.
- Reference cross-platform tools or APIs (such as Azure CLI, REST API, or AzCopy) where possible for managing permissions, and provide examples for their use on Linux.
Create pull request