From b00931352f772f55d831fe58067b79cedab4f8b9 Mon Sep 17 00:00:00 2001
From: Sebastian Kippe <sebastian@kip.pe>
Date: Tue, 6 Aug 2019 13:16:07 +0200
Subject: [PATCH] Improve README

---
 README.md | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index af0054b..90d1862 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,26 @@
 # gitea.kosmos.org
 
 This repository contains configuration files and other assets, that are used to
-deploy and operate this Gitea instance.
+deploy and operate this Gitea instance. Feel free to [open
+issues](https://gitea.kosmos.org/kosmos/gitea.kosmos.org/issues) for questions,
+suggestions, bugs, to-do items, and whatever else you want to discuss or
+resolve.
+
+## Building & deploying
 
 To create a new image containing the customizations:
 
 Edit `packer/custom.json` to increment the tag, then run this script (needs
 [Packer](https://www.packer.io/) in your path)
 
-```
-./script/build_customizations_image
-```
+
+    ./script/build_customizations_image
+
 
 Then edit `kubernetes/gitea-server.yaml` to use the new tag
 (`image: eu.gcr.io/fluted-magpie-218106/gitea_custom:$VERSION`) and apply the
 change:
 
-```
-cd kubernetes
-kubectl apply -f gitea-server.yaml
-```
 
-Feel free to [open issues] for questions, suggestions, bugs, to-do items, and
-whatever else you want to discuss or resolve.
-
-[open issues]: https://gitea.kosmos.org/kosmos/gitea.kosmos.org/issues
+    cd kubernetes
+    kubectl apply -f gitea-server.yaml