From 07f3266e2cd84509c215577c5f94a284841b58b2 Mon Sep 17 00:00:00 2001
From: Justin Ross <jross@apache.org>
Date: Fri, 10 Nov 2023 05:35:37 -0500
Subject: [PATCH] WIP

---
 README.md   | 18 ++++++++++++------
 skewer.yaml | 18 ++++++++++++------
 2 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index b92b0bc..12f7b7c 100644
--- a/README.md
+++ b/README.md
@@ -123,6 +123,14 @@ kubectl config set-context --current --namespace east
 
 ## Step 4: Install Skupper in your namespaces
 
+Use the `kubectl apply` command to install the Skupper router
+and controller in each namespace.
+
+**Note:** If you are using Minikube, [you need to start `minikube
+tunnel`][minikube-tunnel] before you install Skupper.
+
+[minikube-tunnel]: https://skupper.io/start/minikube.html#running-minikube-tunnel
+
 _**Console for west:**_
 
 ~~~ shell
@@ -199,15 +207,14 @@ its API.
 
 [backend.yaml](east/backend.yaml):
 
-~~~ yaml
-apiVersion: apps/v1
+<pre>apiVersion: apps/v1
 kind: Deployment
 metadata:
   name: backend
   labels:
     app: backend
-  annotations:
-    skupper.io/proxy: tcp
+  <b>annotations:
+    skupper.io/proxy: tcp</b>
 spec:
   selector:
     matchLabels:
@@ -222,8 +229,7 @@ spec:
         - name: backend
           image: quay.io/skupper/hello-world-backend
           ports:
-            - containerPort: 8080
-~~~
+            - containerPort: 8080</pre>
 
 Now we're ready to apply everything.  Use the `kubectl apply`
 command with the resource definitions for each site.
diff --git a/skewer.yaml b/skewer.yaml
index f893784..15981c4 100644
--- a/skewer.yaml
+++ b/skewer.yaml
@@ -34,6 +34,14 @@ steps:
   - standard: access_your_clusters
   - standard: set_up_your_namespaces
   - title: Install Skupper in your namespaces
+    preamble: |
+      Use the `kubectl apply` command to install the Skupper router
+      and controller in each namespace.
+
+      **Note:** If you are using Minikube, [you need to start `minikube
+      tunnel`][minikube-tunnel] before you install Skupper.
+
+      [minikube-tunnel]: https://skupper.io/start/minikube.html#running-minikube-tunnel
     commands:
       west:
         - run: kubectl apply -f skupper.yaml
@@ -103,15 +111,14 @@ steps:
 
       [backend.yaml](east/backend.yaml):
 
-      ~~~ yaml
-      apiVersion: apps/v1
+      <pre>apiVersion: apps/v1
       kind: Deployment
       metadata:
         name: backend
         labels:
           app: backend
-        annotations:
-          skupper.io/proxy: tcp
+        <b>annotations:
+          skupper.io/proxy: tcp</b>
       spec:
         selector:
           matchLabels:
@@ -126,8 +133,7 @@ steps:
               - name: backend
                 image: quay.io/skupper/hello-world-backend
                 ports:
-                  - containerPort: 8080
-      ~~~
+                  - containerPort: 8080</pre>
 
       Now we're ready to apply everything.  Use the `kubectl apply`
       command with the resource definitions for each site.