Refs #8142: Samba Server Deploy - Role WIP - Refs comments

roles/services/tasks/adsamba.yml

@@ -1,3 +1,15 @@
+# Provisioning of Samba. Samba is able to serve as an Active Directory (AD) domain controller (DC).
+# The entire process of setting up a Samba domain controller consists of 5 steps which are relatively straight forward. These steps are as follows:
+# 1. Installation of Samba and associated packages
+# 2. Deletion of pre-configured Samba and Kerberos placeholder configuration files
+# 3. Provisioning of Samba using the automatic provisioning tool
+# 4. Editing of the smb.conf as needed (enabling of Group Policy and/or other features as needed) see Group Policy for more information
+# 5. Any environmental configuration based on Unix/Linux Distribution
+# 
+# https://learn.microsoft.com/en-us/troubleshoot/windows-server/active-directory/active-directory-domain-join-troubleshooting-guidance
+# https://learn.microsoft.com/en-us/windows/win32/api/lmjoin/nf-lmjoin-netvalidatename
+
+
 - name: Install adSamba packages
   package:
     name: "{{ dcsamba_base_packages }}"