From 09ed361f9bb9302ce0856e789062d1906bfbbe24 Mon Sep 17 00:00:00 2001
From: Cristian Klein <cristian.klein@elastisys.com>
Date: Thu, 14 Sep 2023 14:07:04 +0200
Subject: [PATCH] Improve admin landing page

---
 docs/index.md                            |  2 +-
 docs/operator-manual/index.md            | 73 +++++++++++++++++++++---
 docs/operator-manual/on-prem-standard.md |  2 +
 extra_sass/style.css.scss                | 20 ++++++-
 4 files changed, 87 insertions(+), 10 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index f045878e9d6..877036e8d8c 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -144,7 +144,7 @@ Elastisys Compliant Kubernetes enables organizations across Europe to accelerate
       :fontawesome-solid-laptop-code:
       Consulting
     </dt>
-    <dd>
+    <dd class="grow-me">
       Extend your team with our cloud native experts. Develop and deploy apps faster and with more confidence in a DevSecOps fashion.
     </dd>
     <dd>
diff --git a/docs/operator-manual/index.md b/docs/operator-manual/index.md
index f080af502bc..80742441aa0 100644
--- a/docs/operator-manual/index.md
+++ b/docs/operator-manual/index.md
@@ -1,11 +1,70 @@
+---
+hide:
+- toc
+---
 # Platform Administrator Manual Overview
 
-This manual is for Compliant Kubernetes administrators.
+<div class="landing-page" markdown="1">
 
-Platform Administrator can be described via the following user stories:
+Compliant Kubernetes abstracts away a lot of complexity from Application Developers.
+Unfortunately, someone somewhere needs to take care of that complexity.
+That person is you, the platform administrator.
 
-* As a Platform Administrator I want to create/destroy/upgrade a Compliant Kubernetes cluster.
-* As a Platform Administrator I want to re-configure a Compliant Kubernetes cluster.
-* As an on-call Platform Administrator I want to be alerted when abnormal activity is detected, suggesting a pending intrusion.
-* As an on-call Platform Administrator I want to be alerted when the Compliant Kubernetes cluster is unhealthy.
-* As an on-call Platform Administrator I want "break glass" to investigate and recover an unhealthy Compliant Kubernetes cluster.
+Setting up Compliant Kubernetes is not for the faint hearted.
+We recommend you to proceed in 4 steps as shown below:
+
+<nav markdown="1">
+<dl class="columns-2" markdown="1">
+  <div markdown="span">
+    <dt markdown="span">
+      :fontawesome-solid-laptop-code:
+      Phase 1: Try out the end result
+    </dt>
+    <dd>
+        Validate that the application team's needs will be satisfied.
+        Start with Compliant Kubernetes managed by an experienced platform team on a trusted EU cloud infrastructure.
+    </dd>
+    <dd>
+      <a role="button" href="https://elastisys.com/managed-services/">Learn more</a>
+    </dd>
+  </div>
+  <div markdown="span">
+    <dt markdown="span">
+      :fontawesome-solid-magnifying-glass:
+      Phase 2: Infrastructure audit
+    </dt>
+    <dd class="grow-me">
+      Clarify the capabilities of your infrastructure and ways of working with your infrastructure team.
+    </dd>
+    <dd>
+      <a role="button" href="./provider-audit/">Learn more</a>
+    </dd>
+  </div>
+  <div markdown="span">
+    <dt markdown="span">
+      :fontawesome-solid-gears:
+      Phase 3: Compliant Kubernetes setup
+    </dt>
+    <dd class="grow-me">
+      Now that the infrastructure is in place, you're ready to configure and install Compliant Kubernetes.
+    </dd>
+    <dd>
+      <a role="button" href="./on-prem-standard/">Learn more</a>
+    </dd>
+  </div>
+  <div markdown="span">
+    <dt markdown="span">
+      :fontawesome-solid-user-graduate:
+      Phase 4: Deepen your knowledge and operate
+    </dt>
+    <dd class="grow-me" markdown="span">
+      Practice [maintenance](maintenance.md), [capacity management](capacity-management.md) and [troubleshooting](troubleshooting.md).
+    </dd>
+    <dd>
+      <a role="button" href="https://elastisys.com/free-guide-how-to-operate-a-secure-kubernetes-platform/">Learn more</a>
+    </dd>
+  </div>
+</dl>
+</nav>
+
+</div>
diff --git a/docs/operator-manual/on-prem-standard.md b/docs/operator-manual/on-prem-standard.md
index 72213be6b7a..7837bd70953 100644
--- a/docs/operator-manual/on-prem-standard.md
+++ b/docs/operator-manual/on-prem-standard.md
@@ -16,6 +16,8 @@ This document contains instructions on how to set-up a new Compliant Kubernetes
     - Identity Provider (IdP) choice and configuration. See [this page](../user-guide/prepare-idp.md).
     - On-call Management Tool (OMT) choice and configuration
 
+1. Make sure you [install all prerequisites](getting-started.md) on your laptop.
+
 1. Prepare Ubuntu-based VMs:
     If you are using public clouds, you can create VMs using the scripts included in Kubespray:
     - For Azure, use [AzureRM scripts](https://github.com/kubernetes-sigs/kubespray/tree/master/contrib/azurerm).
diff --git a/extra_sass/style.css.scss b/extra_sass/style.css.scss
index ee158f3ddb2..a619bdec475 100644
--- a/extra_sass/style.css.scss
+++ b/extra_sass/style.css.scss
@@ -1,8 +1,25 @@
 /* Stuff on the landing page needs to be more specific than mkdocs-material's CSS. */
 .md-content .landing-page {
   .columns {
-    display: flex;
     flex-flow: row;
+
+    div {
+      width: 100%;
+    }
+  }
+
+  .columns-2 {
+    flex-flow: row wrap;
+
+    div {
+      flex-grow: 1;
+      width: 40%;
+    }
+  }
+
+  .columns,
+  .columns-2 {
+    display: flex;
     margin: 0;
     padding: 0;
     gap: 10px;
@@ -12,7 +29,6 @@
     }
 
     div {
-      width: 100%;
       border: 5px solid var(--esys-blue-04);
       text-align: center;
       padding: 12px 24px;