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:
⚠️
windows_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation is generally balanced in its protocol descriptions, but there are subtle Windows biases. SMB (the Windows protocol) is described as 'officially supported' for Windows and macOS, while Linux SMB (via Samba) is noted as unsupported. Windows terminology and tools (Active Directory, NTFS ACLs, SID translation, NTLM) are referenced as defaults or requirements, and Linux/UNIX equivalents are not always given equal prominence. There are no Linux command-line examples for SMB access or configuration, and the only example command provided is for NFS (rpcinfo), with no equivalent for SMB. The documentation assumes Active Directory as the primary identity provider, with LDAP as a secondary mention.
Recommendations:
- Provide explicit Linux/Samba examples for SMB access and configuration, including sample mount commands and troubleshooting steps.
- Clarify the support status for Linux SMB clients and provide guidance or best practices for their use, even if not officially supported.
- When discussing identity management, give equal detail to LDAP and UNIX/Linux name services as to Active Directory.
- Include Linux/UNIX terminology and tools (e.g., idmap, getfacl/setfacl, nsswitch.conf) alongside Windows terms like NTFS and SID.
- Where possible, avoid presenting Windows/Active Directory as the default or only supported scenario; instead, present both Windows and Linux/UNIX options in parallel.
- Add Linux-focused troubleshooting and configuration sections for dual-protocol environments, including common issues with UID/GID mapping and permissions.
Create pull request