diff --git a/index.md b/index.md
new file mode 100644
index 0000000..fe40705
--- /dev/null
+++ b/index.md
@@ -0,0 +1,86 @@
+---
+title: users
+type: docs
+---
+
+Manage users and default bash environment
+
+* [Default Variables](#default-variables)
+  * [users_bash_bashrc_overrides](#users-bash-bashrc-overrides)
+  * [users_default_groups](#users-default-groups)
+  * [users_default_umask](#users-default-umask)
+  * [users_default_users](#users-default-users)
+  * [users_global_bash_aliases](#users-global-bash-aliases)
+* [Dependencies](#dependencies)
+
+---
+
+## Default Variables
+
+### users_bash_bashrc_overrides
+
+#### Default value
+
+```YAML
+users_bash_bashrc_overrides: []
+```
+
+#### Example usage
+
+```YAML
+users_bash_bashrc_overrides:
+  - /etc/skel/.bashrc
+  - /root/.bashrc
+```
+
+### users_default_groups
+
+#### Default value
+
+```YAML
+users_default_groups: []
+```
+
+### users_default_umask
+
+#### Default value
+
+```YAML
+users_default_umask: '022'
+```
+
+### users_default_users
+
+#### Default value
+
+```YAML
+users_default_users: []
+```
+
+#### Example usage
+
+```YAML
+users_default_users:
+  - name: admin
+    groups:
+      - wheel
+    password: "secure"
+    key: "ssh-ed25519 AAAA..."
+    shell: /bin/bash
+```
+
+### users_global_bash_aliases
+
+#### Default value
+
+```YAML
+users_global_bash_aliases:
+  - alias: ll
+    command: ls -lh
+  - alias: la
+    command: ls -lha
+```
+
+## Dependencies
+
+None.