From beaad55ee4ede2470741e3a5a1b7b984b8da27eb Mon Sep 17 00:00:00 2001
From: Thorben Denzer <denzer@atix.de>
Date: Wed, 27 Mar 2024 08:47:19 +0100
Subject: [PATCH] Document new UI that allows importing/overriding Ansible
 variables from YAML-files in foreman_ansible.

---
 .../assembly_getting-started-with-ansible.adoc   |  2 ++
 ...orting-ansible-variables-from-yaml-files.adoc | 16 ++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 guides/common/modules/proc_importing-ansible-variables-from-yaml-files.adoc

diff --git a/guides/common/assembly_getting-started-with-ansible.adoc b/guides/common/assembly_getting-started-with-ansible.adoc
index ecda740eac2..39b4470aab1 100644
--- a/guides/common/assembly_getting-started-with-ansible.adoc
+++ b/guides/common/assembly_getting-started-with-ansible.adoc
@@ -10,6 +10,8 @@ include::modules/proc_importing-ansible-roles-and-variables.adoc[leveloffset=+1]
 
 include::modules/proc_overriding-ansible-variables-in-project.adoc[leveloffset=+1]
 
+include::modules/proc_importing-ansible-variables-from-yaml-files.adoc[leveloffset=+1]
+
 ifndef::foreman-deb[]
 include::modules/proc_adding-rhel-system-roles.adoc[leveloffset=+1]
 endif::[]
diff --git a/guides/common/modules/proc_importing-ansible-variables-from-yaml-files.adoc b/guides/common/modules/proc_importing-ansible-variables-from-yaml-files.adoc
new file mode 100644
index 00000000000..21f77cd25bd
--- /dev/null
+++ b/guides/common/modules/proc_importing-ansible-variables-from-yaml-files.adoc
@@ -0,0 +1,16 @@
+[id="Importing_Ansible_Variables_From_Yaml_Files_{context}"]
+= Importing Ansible variables from YAML files
+
+You can import Ansible variables from a `.yaml` file to {Project} within the {ProjectWebUI}.
+
+.Prerequisites
+* You must have at least one Ansible role imported.
+For more information, see xref:Importing_Ansible_Roles_and_Variables_{context}[].
+
+.Procedure
+. In the {ProjectWebUI}, navigate to *Configure* > *Ansible* > *Variables*.
+. Click *Import from YAML-File* in the toolbar.
++
+A wizard opens to show you the next steps to import and override Ansible variables.
+Ensure that variables are unique per Ansible role.
+. Click *Finish* to import Ansible variables into {Project}.