Add 'Home'

Home.md

@@ -0,0 +1,41 @@
+# markuman.nextcloud
+
+### Authentication
+
+Evey module and plugin supports the following parameters for authentication and communication with your nextcloud instance.
+
+```yml
+  module_defaults:
+    markuman.nextcloud:
+      host: localhost
+      user: ansible
+      api_token: nextcloud_collection
+      ssl_mode: skip
+```
+
+However, `host`, `user` and `api_token` can also be set via ENV variable.
+
+| **Ansible Parameter** | **ENV Variable** |
+| --- | --- |
+| `host` | `NEXTCLOUD_HOST` |
+| `user` | `NEXTCLOUD_USER` |
+| `api_token` | `NEXTCLOUD_TOKEN` |
+
+
+##### ssl_mode
+
+`ssl_mode` parameters default value is `https`.  
+* Possible values `https`, `http`, `skip` (_skips ssl verification_)
+
+### Modules
+
+* [`file`](file) - download, upload and delete files
+* [`talk`](talk) - post messages in conversations
+* [`user`](user) - maintain nextcloud users
+* [`password`](password) - create, update and delete [passwords](https://apps.nextcloud.com/apps/passwords)
+* [`password_info`](password_info) - read-out [passwords](https://apps.nextcloud.com/apps/passwords) details
+
+
+### lookup plugins
+
+* [`password`](passwords) - read-out [passwords](https://apps.nextcloud.com/apps/passwords)