Sync docs from infrahub repo

opsmill · Feb 17, 2025 · 6f5372e · 6f5372e
1 parent 328a9ad
commit 6f5372e
Show file tree

Hide file tree

Showing 10 changed files with 11 additions and 19 deletions.
diff --git a/docs/docs/guides/generator.mdx b/docs/docs/guides/generator.mdx
@@ -349,3 +349,8 @@ Now that we have the latest changes, [add your repository to Infrahub](./reposit
 ![generator ci/cd](../media/guides/generator_pc_1.png)
 8. Click the **Refresh diff** button to see the **widget3** resources created by the generator
 ![data refresh](../media/guides/generator_pc_2.png)
+
+:::success Examples
+
+- Want to read how Generators can be used to create a service catalog? See our blog post on [How to Turn Your Source of Truth into a Service Factory](https://www.opsmill.com/how-to-turn-your-source-of-truth-into-a-service-factory/).
+:::
diff --git a/docs/docs/overview/data.mdx b/docs/docs/overview/data.mdx
@@ -2,8 +2,6 @@
 title: Data input and sync
 ---
 
-# Data input and sync
-
 ![Infrahub data input and sync](./../media/overview-data.excalidraw.svg)
 
 When a schema has been loaded in to Infrahub, data can be populated or synced through multiple methods:

diff --git a/docs/docs/overview/generators.mdx b/docs/docs/overview/generators.mdx
@@ -1,9 +1,6 @@
 ---
 title: Infrahub generators
 ---
-import ReferenceLink from "../../src/components/Card";
-
-# Infrahub generators
 
 Generators in Infrahub are tools that automatically create infrastructure objects based on predefined templates and user inputs. They serve as a way to streamline the process of setting up complex infrastructure stacks while allowing for customization.
 
@@ -31,6 +28,11 @@ Having a flexible schema opens up new possibilities not previously available. In
 
 Downstream objects are linked to the generator. If a business service needs updating or expansion, all needed changes can be generated to keep the infrastructure consistent and validated.
 
+:::success Examples
+
+- Want to read how Generators can be used to create a service catalog? See our blog post on [How to Turn Your Source of Truth into a Service Factory](https://www.opsmill.com/how-to-turn-your-source-of-truth-into-a-service-factory/).
+:::
+
 ## More information
 
 For more details, you can refer to the [generator topic](../topics/generator.mdx).
diff --git a/docs/docs/overview/integrations.mdx b/docs/docs/overview/integrations.mdx
@@ -1,9 +1,6 @@
 ---
 title: Infrahub integrations
 ---
-import ReferenceLink from "../../src/components/Card";
-
-# Infrahub integrations
 
 Infrahub offers robust integrations with both Ansible and Nornir, which facilitate the automation and management of infrastructure tasks.
 

diff --git a/docs/docs/overview/interfaces.mdx b/docs/docs/overview/interfaces.mdx
@@ -2,8 +2,6 @@
 title: Ways to interface with Infrahub
 ---
 
-# Ways to interface with Infrahub
-
 ![Infrahub interfaces](./../media/overview-interfaces.excalidraw.svg)
 
 Managing infrastructure at scale often means many people, teams, workflows and other systems must interact with the Infrahub infrastructure management platform. Infrahub provides multiple methods to interact:

diff --git a/docs/docs/overview/readme.mdx b/docs/docs/overview/readme.mdx
@@ -3,8 +3,6 @@ title: Infrahub Overview
 ---
 import ReferenceLink from "../../src/components/Card";
 
-# Infrahub overview
-
 ![Infrahub architecture](./../media/overview.excalidraw.svg)
 
 Infrahub acts as a central hub to manage all of the information and code that powers your infrastructure. At its heart, Infrahub is built on 3 fundamental pillars:

diff --git a/docs/docs/overview/schema.mdx b/docs/docs/overview/schema.mdx
@@ -2,8 +2,6 @@
 title: Schema design
 ---
 
-# Schema design
-
 ![Infrahub schema](./../media/overview-schema.excalidraw.svg)
 
 A core feature of Infrahub is the ability to define a relational model to describe the infrastructure, design and business logic in a way that's specific to each organization's needs, while allowing for the model to be changed via version control over time.

diff --git a/docs/docs/overview/transformations.mdx b/docs/docs/overview/transformations.mdx
@@ -2,8 +2,6 @@
 title: Data transformations
 ---
 
-# Data transformations
-
 ![Transformations](./../media/overview-transformations.excalidraw.svg)
 
 Transformations in InfraHub are operations that allow users to extract and export their infrastructure data in a structured and repeatable way. It involves converting data retrieved via GraphQL queries into a desired format, using either Jinja2 templates or Python code.

diff --git a/docs/docs/overview/versioning.mdx b/docs/docs/overview/versioning.mdx
@@ -3,8 +3,6 @@ title: Version control, CI and checks
 ---
 import ReferenceLink from "../../src/components/Card";
 
-# Version control, CI and checks
-
 ![Infrahub Version Control](../media/overview-versioning.excalidraw.svg)
 
 Infrahub integrates version control directly into its graph database, providing robust capabilities for managing changes to infrastructure data. These features collectively enhance the ability to manage and control changes to infrastructure data, making Infrahub a powerful tool for infrastructure management and automation.

diff --git a/docs/docs/topics/generator.mdx b/docs/docs/topics/generator.mdx
@@ -11,7 +11,7 @@ A `Generator` is a generic plugin that queries data and creates new nodes and re
 :::success Examples
 
 - Within your [schema](schema) you could create an abstract service object that through a Generator creates other nodes.
-
+- Want to read how Generators can be used to create a service catalog? See our blog post on [How to Turn Your Source of Truth into a Service Factory](https://www.opsmill.com/how-to-turn-your-source-of-truth-into-a-service-factory/).
 :::
 
 ## High level design