From 0342ba0890a2ca1e90df4526cca3cd78e9fb19b7 Mon Sep 17 00:00:00 2001
From: Daniel Hougaard <62331820+DanielHougaard@users.noreply.github.com>
Date: Sat, 15 Jun 2024 02:45:11 +0200
Subject: [PATCH] Update ansible.mdx

---
 docs/integrations/platforms/ansible.mdx | 43 ++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/docs/integrations/platforms/ansible.mdx b/docs/integrations/platforms/ansible.mdx
index ad95d0d5d..321dbec6e 100644
--- a/docs/integrations/platforms/ansible.mdx
+++ b/docs/integrations/platforms/ansible.mdx
@@ -3,7 +3,48 @@ title: "Ansible"
 description: "Learn how to use Infisical for secret management in Ansible."
 ---
 
-The documentation for using Infisical to manage secrets in Ansible is currently available [here](https://galaxy.ansible.com/ui/repo/published/infisical/vault/).
+You can find the Infisical Ansible collection on [Ansible Galaxy](https://galaxy.ansible.com/ui/repo/published/infisical/vault/).
+
+
+This Ansible Infisical collection includes a variety of Ansible content to help automate the management of Infisical services. This collection is maintained by the Infisical team.
+
+
+## Ansible version compatibility
+Tested with the Ansible Core >= 2.12.0 versions, and the current development version of Ansible. Ansible Core versions prior to 2.12.0 have not been tested.
+
+## Python version compatibility
+This collection depends on the Infisical SDK for Python.
+
+Requires Python 3.7 or greater.
+
+## Installing this collection
+You can install the Infisical collection with the Ansible Galaxy CLI:
+
+```bash 
+$ ansible-galaxy collection install infisical.vault
+```
+
+The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip:
+  
+```bash
+$ pip install infisical-python
+```
+
+## Using this collection
+
+You can either call modules by their Fully Qualified Collection Name (FQCN), such as `infisical.vault.read_secrets`, or you can call modules by their short name if you list the `infisical.vault` collection in the playbook's collections keyword:
+
+
+```bash
+---
+vars:
+  read_all_secrets_within_scope: "{{ lookup('infisical.vault.read_secrets', universal_auth_client_id='<>', universal_auth_client_secret='<>', project_id='<>', path='/', env_slug='dev', url='https://spotify.infisical.com') }}"
+  # [{ "key": "HOST", "value": "google.com" }, { "key": "SMTP", "value": "gmail.smtp.edu" }]
+
+  read_secret_by_name_within_scope: "{{ lookup('infisical.vault.read_secrets', universal_auth_client_id='<>', universal_auth_client_secret='<>', project_id='<>', path='/', env_slug='dev', secret_name='HOST', url='https://spotify.infisical.com') }}"
+  # [{ "key": "HOST", "value": "google.com" }]
+```
+
 
 ## Troubleshoot