feat: UI overhaul (#20)

* feat: docs restructuring

* yet better structures
these commit messages suck ik
it doesnt matter it's just md docs

* final homepage cleanup

Author: toto04

README.md

@@ -1,41 +1,40 @@
-# Website
+# PoliNetwork Docs
+
+Welcome to the PoliNetwork documentation site. Here you will find guides, tutorials,
+and other resources to help you get started with contributing to PoliNetwork's projects.
+
+## Website
 
 This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
 
 ### Installation
 
-```
-$ yarn
+```sh
+pnpm install
 ```
 
 ### Local Development
 
-```
-$ yarn start
+```sh
+pnpm start
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
 ### Build
 
-```
-$ yarn build
+```sh
+pnpm build
 ```
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-### Deployment
-
-Using SSH:
+You can then serve your static build by running:
 
+```sh
+pnpm serve
 ```
-$ USE_SSH=true yarn deploy
-```
-
-Not using SSH:
 
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
+### Deployment
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+This website is deployed using GitHub Pages. The deployment process is automated using GitHub Actions.

docs/Infra/_category_.json

@@ -9,12 +9,22 @@ Let's discover **PoliNetwork's Infrastructure in less than 5 minutes**.
 ## Getting Started
 
 ### Where
+
 Our infrastructure is deployed on Azure West Europe (Amsterdam).
 The description is found [here](https://github.com/polinetworkorg/terraform), described in Terraform (IaC).
 
 ### What
+
 The core is a AKS Cluster (Kubernetes), in combination with various other services (KeyVault, Disks, Azure Active Directory, ...)
 
 ### Why
+
 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.  
+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
+
+The best place to start is going through the [Tutorials](./Tutorials/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 [How To Guides](./How%20To%20Guides/Adding%20a%20Secret).
+