feat: search, graphs, theme (#26)

* ahh quetti graphs

* launch me off a cliff

* graphs!

* fix: broken links

* docs: better getting starter graph (#29)

* docs: better getting-started graph

* fix: broken links

---------

Co-authored-by: Lorenzo <[email protected]>

---------

Co-authored-by: Tommaso Morganti <[email protected]>

Author: lorenzocorallo

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node-terminal",
+      "name": "Run Script: start",
+      "request": "launch",
+      "command": "pnpm run start",
+      "cwd": "${workspaceFolder}"
+    }
+  ]
+}

docs/infrastructure/01-Introduction.md

@@ -23,13 +23,12 @@ Why not a simple VM?
 AKS gives us the flexibility of a 10s pod deployment, reliability (with ArgoCD ensuring all pods are up and running all the time) and allows us to be more precise and clean in our infrastructure, with better monitoring and allocated resources for each application depending on the importance.  
 
 ## About this documentation
+
 :::important
 Most of the docs explain procedures with the Azure CLI and the Kubernetes CLI.  
-Make sure to [install and configure them](./Tutorials/setup#azure-cli--kubectl) to follow along.  
+Make sure to [install and configure them](./getting-started/setup#azure-cli--kubectl) to follow along.  
 Alternatively, you can see the [official Azure documentation](https://learn.microsoft.com/en-us/azure/?product=popular) for how to use the Azure portal.
 :::
 
-
-The best place to start is going through the [Tutorials](./Tutorials/setup) section to get a high level overview of how things are organized.  
+The best place to start is going through the [Getting Started](./getting-started/setup) section to get a high level overview of how things are organized.  
 If you're looking for a guide on how to achieve a specific outcome, you can look in the [Guides](./Guides/add-a-new-secret).
-

docs/infrastructure/02-getting-started/_category_.yml

@@ -0,0 +1,2 @@
+label: Getting Started
+position: 2

docs/infrastructure/02-getting-started/basic-knowledge/Terraform.md

@@ -0,0 +1,2 @@
+label: Basic Knowledge
+position: 2

docs/infrastructure/02-getting-started/basic-knowledge/_category_.yml

@@ -0,0 +1,36 @@
+---
+title: Basic Knowledge
+---
+import DocCardList from '@theme/DocCardList';
+
+## Overview
+
+This section explains how we organized our infrastructure.
+
+Everything regarding the deployment of apps and services is divided into two repositories:
+
+- [polinetworkorg/terraform](https://github.com/polinetworkorg/terraform) - Contains the Terraform code to deploy the infrastructure. This defines the resources that are created on Azure, from specific things like KeyVaults, to the Kubernetes cluster itself.
+- [polinetworkorg/polinetwork-cd](https://github.com/polinetworkorg/polinetwork-cd) - Our GitOps repo, contains the manifests that define deployments specific for each app or service. This repository is connected to the ArgoCD instance running on the Kubernetes cluster.
+
+```mermaid
+flowchart TD
+  subgraph Github
+    tf([**terraform**])
+    cd([**polinetwork-cd**])
+  end
+  subgraph Azure
+    vm[VMs and other resources]
+    subgraph k8s[K8S cluster]
+      argocd[ArgoCD]
+      app@{ shape: processes, label: "Apps / Services" }
+    end
+  end
+
+  tf -.-> vm
+  tf -.-> k8s
+  vm <--> k8s
+  cd <-.-> argocd --> app
+```
+
+<!-- markdownlint-disable-next-line -->
+<DocCardList />