From 735b329a4f05921c9df2d2af6df167789f44eca8 Mon Sep 17 00:00:00 2001
From: StephenJamesSmith <stesmith@redhat.com>
Date: Sun, 18 May 2025 14:10:21 -0400
Subject: [PATCH] TELCODOCS-2057: First draft

---
 _topic_maps/_topic_map.yml                    |  2 ++
 .../gaudi-ai-accelerator.adoc                 | 22 +++++++++++++++++++
 .../gaudi-ai-accelerator-prerequisites.adoc   | 16 ++++++++++++++
 3 files changed, 40 insertions(+)
 create mode 100644 hardware_accelerators/gaudi-ai-accelerator.adoc
 create mode 100644 modules/gaudi-ai-accelerator-prerequisites.adoc

diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
index b7fbf00d3b..d76f19fc29 100644
--- a/_topic_maps/_topic_map.yml
+++ b/_topic_maps/_topic_map.yml
@@ -3613,6 +3613,8 @@ Topics:
   File: nvidia-gpu-architecture
 - Name: AMD GPU Operator
   File: amd-gpu-operator
+- Name: Intel Gaudi AI accelerators
+  File: gaudi-ai-accelerator
 ---
 Name: Backup and restore
 Dir: backup_and_restore
diff --git a/hardware_accelerators/gaudi-ai-accelerator.adoc b/hardware_accelerators/gaudi-ai-accelerator.adoc
new file mode 100644
index 0000000000..fd3cd43f2f
--- /dev/null
+++ b/hardware_accelerators/gaudi-ai-accelerator.adoc
@@ -0,0 +1,22 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="gaudi-ai-accelerator"]
+= Intel Gaudi AI accelerators
+include::_attributes/common-attributes.adoc[]
+:context: gaudi-ai-accelerator
+
+toc::[]
+
+:FeatureName: Intel Gaudi AI accelerators
+
+You can use Intel Gaudi AI accelerators for your {product-title} generative AI and machine learning (AI/ML) applications. Intel Gaudi AI accelerators offer a cost-efficient, flexible, and scalable solution for optimized deep learning workloads.
+
+Red{nbsp}Hat supports Intel Gaudi 2 and Intel Gaudi 3 devices. Intel Gaudi 3 devices provide significant improvements in training speed and energy efficiency.
+
+include::modules/gaudi-ai-accelerator-prerequisites.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://docs.habana.ai/en/latest/Installation_Guide/Additional_Installation/OpenShift_Installation/index.html[OpenShift Installation] (Intel Gaudi documentation)
+
+* link:https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.20/html/working_with_accelerators/intel-gaudi-ai-accelerator-integration_accelerators#intel-gaudi-ai-accelerator-integration_accelerators[Intel Gaudi AI Accelerator integration]
\ No newline at end of file
diff --git a/modules/gaudi-ai-accelerator-prerequisites.adoc b/modules/gaudi-ai-accelerator-prerequisites.adoc
new file mode 100644
index 0000000000..2117f40e75
--- /dev/null
+++ b/modules/gaudi-ai-accelerator-prerequisites.adoc
@@ -0,0 +1,16 @@
+// Module included in the following assemblies:
+//
+// * hardware_accelerators/gaudi-ai-accelerator.adoc
+
+
+:_mod-docs-content-type: CONCEPT
+[id="gaudi-ai-accelerators-prerequisites_{context}"]
+= Intel Gaudi AI accelerators prerequisites
+
+* You have a working {product-title} cluster with at least one GPU worker node.
+
+* You have access to the {product-title} cluster as a cluster-admin to perform the required steps.
+
+* You have installed {oc-first}.
+
+* You have installed the Node Feature Discovery (NFD) Operator and created a `NodeFeatureDiscovery` instance.
\ No newline at end of file