fix docs deployment

docs/pages/kapitan_overview.md

@@ -2,128 +2,121 @@
 
 ## **Kapitan** at a glance
 
-
-```mermaid
-%%{ init: { securityLevel: 'loose'} }%%
-graph LR
- classDef pink fill:#f9f,stroke:#333,stroke-width:4px,color:#000,font-weight: bold;
- classDef blue fill:#00FFFF,stroke:#333,stroke-width:4px,color:#000,font-weight: bold;
- TARGET1 --> KAPITAN
- TARGET2 --> KAPITAN
- TARGETN --> KAPITAN
- KAPITAN --> EXTERNAL
- KAPITAN --> GENERATORS
- KAPITAN --> HELM
- KAPITAN --> JINJA
- KAPITAN --> JSONNET
- KAPITAN --> KADET
- EXTERNAL --> OUTPUT
- GENERATORS --> OUTPUT
- JINJA --> OUTPUT
- JSONNET --> OUTPUT
- KADET --> OUTPUT
- HELM --> OUTPUT
- GKMS --> REFERENCES
- AWSKMS --> REFERENCES
- VAULT --> REFERENCES
- OTHER --> REFERENCES
- PLAIN --> REFERENCES
- OUTPUT --> TARGETN_OUTPUT
- OUTPUT --> TARGET1_OUTPUT 
- OUTPUT --> TARGET2_OUTPUT 
- REFERENCES --> KAPITAN
- TARGET1_OUTPUT --> DOCUMENTATION 
- TARGET1_OUTPUT --> KUBERNETES
- TARGET1_OUTPUT --> SCRIPTS 
- TARGET1_OUTPUT --> TERRAFORM
- CLASSES --> TARGET1
- CLASSES --> TARGET2
- CLASSES --> TARGETN
-
- subgraph "Inventory"
- CLASSES[classes]
- TARGET1(["target 1"]):::pink
- TARGET2(["target 2"])
- TARGETN(["target N"])
- end
-
- subgraph "references"
- direction TB
- GKMS["GCP KMS"]
- AWSKMS["AWS KMS"]
- VAULT["Hashicorp Vault"]
- OTHER["others"]
- PLAIN["plain"]
- REFERENCES["references"]
- end
-
- KAPITAN(("<img src='/images/kapitan_logo.png'; width='80'/>")):::blue
- click EXTERNAL "/compile#external"
-
- subgraph "Input Types" 
- EXTERNAL["external"]
- GENERATORS["generators"]
- HELM["helm"]
- JINJA["jinja"]
- JSONNET["jsonnet"]
- KADET["kadet"]
- end
-
- OUTPUT{{"compiled output"}}:::blue
-
-
-
- subgraph " "
- TARGET1_OUTPUT([target1]):::pink
- DOCUMENTATION["docs"]
- KUBERNETES["manifests"]
- SCRIPTS["scripts"]
- TERRAFORM["terraform"]
- end
-
- TARGET2_OUTPUT(["target 2"])
- TARGETN_OUTPUT(["target N"])
-
-```
-
 **Kapitan** is a powerful configuration management tool designed to help engineers manage complex systems through code. It centralizes and simplifies the management of configurations with a structured approach that revolves around a few core concepts. 
 
-Let's explore these concepts in a way that's accessible to new users:
+??? note "**Kapitan** diagram"
+ ```mermaid
+ %%{ init: { securityLevel: 'loose'} }%%
+ graph LR
+ classDef pink fill:#f9f,stroke:#333,stroke-width:4px,color:#000,font-weight: bold;
+ classDef blue fill:#00FFFF,stroke:#333,stroke-width:4px,color:#000,font-weight: bold;
+ TARGET1 --> KAPITAN
+ TARGET2 --> KAPITAN
+ TARGETN --> KAPITAN
+ KAPITAN --> EXTERNAL
+ KAPITAN --> GENERATORS
+ KAPITAN --> HELM
+ KAPITAN --> JINJA
+ KAPITAN --> JSONNET
+ KAPITAN --> KADET
+ EXTERNAL --> OUTPUT
+ GENERATORS --> OUTPUT
+ JINJA --> OUTPUT
+ JSONNET --> OUTPUT
+ KADET --> OUTPUT
+ HELM --> OUTPUT
+ GKMS --> REFERENCES
+ AWSKMS --> REFERENCES
+ VAULT --> REFERENCES
+ OTHER --> REFERENCES
+ PLAIN --> REFERENCES
+ OUTPUT --> TARGETN_OUTPUT
+ OUTPUT --> TARGET1_OUTPUT 
+ OUTPUT --> TARGET2_OUTPUT 
+ REFERENCES --> KAPITAN
+ TARGET1_OUTPUT --> DOCUMENTATION 
+ TARGET1_OUTPUT --> KUBERNETES
+ TARGET1_OUTPUT --> SCRIPTS 
+ TARGET1_OUTPUT --> TERRAFORM
+ CLASSES --> TARGET1
+ CLASSES --> TARGET2
+ CLASSES --> TARGETN
+
+ subgraph "Inventory"
+ CLASSES[classes]
+ TARGET1(["target 1"]):::pink
+ TARGET2(["target 2"])
+ TARGETN(["target N"])
+ end
+
+ subgraph "references"
+ direction TB
+ GKMS["GCP KMS"]
+ AWSKMS["AWS KMS"]
+ VAULT["Hashicorp Vault"]
+ OTHER["others"]
+ PLAIN["plain"]
+ REFERENCES["references"]
+ end
+
+ KAPITAN(("<img src='/images/kapitan_logo.png'; width='80'/>")):::blue
+ click EXTERNAL "/compile#external"
+
+ subgraph "Input Types" 
+ EXTERNAL["external"]
+ GENERATORS["generators"]
+ HELM["helm"]
+ JINJA["jinja"]
+ JSONNET["jsonnet"]
+ KADET["kadet"]
+ end
+
+ OUTPUT{{"compiled output"}}:::blue
+
+
+
+ subgraph " "
+ TARGET1_OUTPUT([target1]):::pink
+ DOCUMENTATION["docs"]
+ KUBERNETES["manifests"]
+ SCRIPTS["scripts"]
+ TERRAFORM["terraform"]
+ end
+
+ TARGET2_OUTPUT(["target 2"])
+ TARGETN_OUTPUT(["target N"])
+
+ ```
 
-## Core Concepts of Kapitan
+Let's explore these concepts in a way that's accessible to new users:
 
-### Inventory: The Backbone
+## [**Inventory**](/pages/inventory/introduction/)
 
-At the core of **Kapitan** lies the Inventory, a structured database of variables meticulously organized in YAML files. 
+At the core of **Kapitan** lies the **Inventory**, a structured database of variables meticulously organized in YAML files. 
 This hierarchical setup serves as the single source of truth (SSOT) for your system's configurations, making it easier to manage and reference the essential components of your infrastructure. Whether you're dealing with Kubernetes configurations, Terraform resources, or even business logic, the Inventory allows you to define and store these elements efficiently. This central repository then feeds into **Kapitan**'s templating engines, enabling seamless reuse across various applications and services.
 
-### Templating with Input Types
+## [**Input Types**](/pages/input_types/introduction/)
 
 **Kapitan** takes the information stored in the Inventory and brings it to life through its templating engines upon compilation. This process transforms static data into dynamic configurations, capable of generating a wide array of outputs like Kubernetes manifests, Terraform plans, documentation, and scripts. It's about making your configurations work for you, tailored to the specific needs of your projects.
 
-#### Getting Started with Generators
+See [**Input Types**](/pages/input_types/introduction/) for more
 
-Generators offer a straightforward entry point into using **Kapitan**, requiring minimal to no coding experience. These are essentially pre-made templates that allow you to generate common configuration files, such as Kubernetes manifests, directly from your Inventory data. **Kapitan** provides a wealth of resources, including the **Kapitan** Reference repository and various blog posts, to help users get up and running with generators.
+### [**Generators**](https://generators.kapitan.dev)
 
-#### Kadet: Advanced Configuration with Python
+[**Generators**](https://generators.kapitan.dev) offer a straightforward entry point into using **Kapitan**, requiring minimal to no coding experience. These are essentially pre-made templates that allow you to generate common configuration files, such as Kubernetes manifests, directly from your Inventory data. **Kapitan** provides a wealth of resources, including the [**Kapitan Reference**](https:/kapicorp/kapitan-reference) GitHub repository and various blog posts, to help users get up and running with generators.
 
-For those looking to leverage the full power of **Kapitan**, Kadet introduces a method to define and reuse complex configurations through Python. This internal library facilitates the creation of JSON and YAML manifests programmatically, offering a higher degree of customization and reuse. Kadet empowers users to craft intricate configurations with the simplicity and flexibility of Python.
+### [**Kadet**](https:/kapicorp/kapitan-reference)
 
-### **Kapitan** References: Your Flexible Configuration Superpower
+For those looking to leverage the full power of **Kapitan**, [**Kadet**](https:/kapicorp/kapitan-reference) introduces a method to define and reuse complex configurations through Python. This internal library facilitates the creation of JSON and YAML manifests programmatically, offering a higher degree of customization and reuse. [**Kadet**](https:/kapicorp/kapitan-reference) empowers users to craft intricate configurations with the simplicity and flexibility of Python.
 
-**Kapitan** references provide a secure way to store passwords, settings, and other essential data within your project. Think of them as special code placeholders.
-Flexibility: Update a password once, and Kapitan updates it everywhere automatically.
-Organization: References tidy up your project, especially when you're juggling multiple settings or environments (dev, staging, production).
-Security: Protect sensitive information like passwords with encryption
+## [**References**](/references)
 
-!!! tip
+**Kapitan** [**References**](/references) provide a secure way to store passwords, settings, and other essential data within your project. Think of them as special code placeholders.
 
- Use [Tesoro](https:/kapicorp/tesoro), our **Kubernetes Admission Controller**, to complete your integration with Kubernetes for secure secret decryption on-the-fly.
-
-## Credits
+* **Flexibility**: Update a password once, and Kapitan updates it everywhere automatically.
+* **Organization**: References tidy up your project, especially when you're juggling multiple settings or environments (dev, staging, production).
+**Security**: Protect sensitive information like passwords with encryption
 
-* [Jsonnet](https:/google/jsonnet)
-* [Jinja2](http://jinja.pocoo.org/docs/2.9/)
-* [reclass](https:/salt-formulas/reclass)
+!!! tip
 
-*[SSOT]: Single Source Of Truth
+ Use [Tesoro](https:/kapicorp/tesoro), our **Kubernetes Admission Controller**, to complete your integration with Kubernetes for secure secret decryption on-the-fly.

mkdocs.yml

@@ -85,7 +85,7 @@ nav:
 
 
  - Documentation:
- - Overview: pages/kapitan_overview.md
+ - Core Concepts: pages/kapitan_overview.md
  - Inventory:
  - Introduction: pages/inventory/introduction.md
  - Targets: pages/inventory/targets.md
@@ -113,7 +113,6 @@ nav:
  - searchvar: pages/commands/kapitan_searchvar.md
  - validate: pages/commands/kapitan_validate.md
  - kapitan dotfile: pages/commands/kapitan_dotfile.md
- - Generators: https://generators.kapitan.dev/
  - Blog:
  - 2023:
  - Kapitan Generators: pages/blog/2023-08-27.md
@@ -130,6 +129,8 @@ nav:
  - Documentation: pages/contribute/documentation.md
  - Kapitan Code: pages/contribute/code.md
  - Proposals: proposals.md
+ - Generators: https://generators.kapitan.dev/
+ - Tesoro: https:/kapicorp/tesoro
  - FAQ: FAQ.md
 
 markdown_extensions: