Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..ec28612
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,59 @@
+========
+openldap
+========
+
+Sample pillars
+==============
+
+Client
+------
+
+.. code-block:: yaml
+
+ openldap:
+ client:
+ server:
+ basedn: dc=example,dc=local
+ host: ldap.example.local
+ tls: true
+ port: 389
+ auth:
+ user: cn=admin,dc=example,dc=local
+ password: dummypass
+ entry:
+ people:
+ type: ou
+ classes:
+ - top
+ - organizationalUnit
+ entry:
+ jdoe:
+ type: cn
+ # Change attributes that already exists with different content
+ action: replace
+ # Delete all other attributes
+ purge: true
+ attr:
+ uid: jdoe
+ uidNumber: 20001
+ gidNumber: 20001
+ gecos: John Doe
+ givenName: John
+ sn: Doe
+ homeDirectory: /home/jdoe
+ loginShell: /bin/bash
+ classes:
+ - posixAccount
+ - inetOrgPerson
+ - top
+ - ldapPublicKey
+ - shadowAccount
+ karel:
+ # Simply remove cn=karel
+ type: cn
+ enabled: false
+
+Read more
+=========
+
+- https://docs.saltstack.com/en/latest/ref/states/all/salt.states.ldap.html#manage-entries-in-an-ldap-database