Better readme (#1)

* Improve README by adding image and better description

* Change H4 to H3

* Remove bold parts

Author: otype

README.md

@@ -1,56 +1,70 @@
-# otype.de
+<p align="center">
+	<img src="/images/otype_site.png" alt="otype Site"/>
+</p>
+
+<p>
+	<a href="https://github.com/otype/otype.github.io/commits/master">
+	<img src="https://img.shields.io/github/last-commit/otype/otype.github.io.svg?style=flat-square&logo=github&logoColor=white" alt="GitHub last commit">
+    <a href="https://github.com/otype/otype.github.io/issues">
+    <img src="https://img.shields.io/github/issues-raw/otype/otype.github.io.svg?style=flat-square&logo=github&logoColor=white" alt="GitHub issues">
+    <a href="https://github.com/otype/otype.github.io/pulls">
+    <img src="https://img.shields.io/github/issues-pr-raw/otype/otype.github.io.svg?style=flat-square&logo=github&logoColor=white" alt="GitHub pull requests">
+</p>
+
+This repository contains all files for my sites (identical copies):
+
+- [otype.github.io](https://otype.github.io)
+- [otype.de](https://otype.de)
 
-This repository contains all files for my site [otype.github.io](https://otype.github.io) and [otype.de](https://otype.de). The site is based on [Hugo](https://gohugo.io/).
+The site is based on [Hugo](https://gohugo.io/) and the [hugo-goa](https://github.com/kaapiandcode/hugo-goa) theme.
 
-## Running locally
+## Getting started
 
-1. Clone this repo (assumes you are using [gh](https://cli.github.com/)):
-```
-gh repo clone otype/otype.de
-```
+### Requirements
 
-2. Run setup:
+- [Golang](https://go.dev/), installed e.g. via [goenv](https://github.com/syndbg/goenv)
+- [Hugo](https://gohugo.io/)
+- [gh](https://cli.github.com/)
 
+### Development setup
+
+1. Clone this repo.
+```console
+$ gh repo clone otype/otype.github.io
 ```
-make setup
+
+2. Run setup.
+
+```console
+$ make setup
 ````
 
-3. Run server:
+3. Run server.
 
+```console
+$ make run
 ```
-make run
-```
-
-## Release and deploy
 
-This will deploy to:
-- [otype.github.io](https://otype.github.io) and
-- [otype.de](https://otype.de)
+### Release and deploy a new version
 
-Assumption:
-You have made all changes and pushed to `main`.
+1. Commit and push all changes to `main`.
 
-Build the site:
+2. Build the site. Default `Makefile` target will run `hugo`.
 
-```
-make
+```console
+$ make
 ```
 
-Now, create a release (pick a new tag version):
+3. Create a release. Pick a new `tag` version. If unclear check the existing [tags](https://github.com/otype/otype.github.io/tags) in this repository.
 
-E.g.
-```
-gh release create v1.2 --generate-notes
+```console
+$ gh release create v1.2 --generate-notes
 ```
 
-Then, deploy:
+4. Deploy. This automatically updates [otype.github.io](https://otype.github.io) and copies all files to [otype.de](https://otype.de).
 
-```
-make deploy
+```console
+$ make deploy
 ```
 
-Deploy will implicitly ...
-- checkout branch `public`,
-- rebase `main`,
-- push to `public`
-- and `scp` all files to Uberspace.
+The Makefile `deploy` target will implicitly checkout branch `public`, rebase `main`, push to `public` and `scp` all files to Uberspace.