From f970225d82134a107430d89ede5d0521b33d20e6 Mon Sep 17 00:00:00 2001
From: zimbatm <zimbatm@zimbatm.com>
Date: Sun, 3 May 2020 15:10:15 +0200
Subject: [PATCH] cleanup the README

---
 README.md | 42 +++++++++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 63e1fd4..398e653 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,15 @@
 # nix-community infrastructure
 
-This documents and configures the infrastructure used for the `nix-community` Github organisation.
+Welcome to the Nix Community infrastructure project. This project holds all
+the NixOS and Terraform configuration for this organization.
 
-## Usage
+## Support
 
-`./deploy`
+If you hit any issues, ping us on IRC in the #nix-community channel (see the
+admin list below) or create an issue here:
+[New Issue](https://github.com/nix-community/infra/issues/new).
 
-## Hosts
-
-* ![build01](https://healthchecks.io/badge/c9e58e14-c706-4084-959b-17b06fbd124f/QFBOLbO1/build01.svg)
-
-## Administrators
-
-The list of people who can deploy:
+### Administrators
 
 * @adisbladis
 * @flokli
@@ -23,4 +20,27 @@ The list of people who can deploy:
 
 ## Services
 
-* buildkite on build01
+* https://hydra.nix-community.org - on build01
+* BuildKite agent - on build01
+* GitLab agent - on build01
+* ryantm-updater bot - on build01
+
+## Hosts
+
+### `build01` ![build01](https://healthchecks.io/badge/c9e58e14-c706-4084-959b-17b06fbd124f/QFBOLbO1/build01.svg)
+
+This machine is perfect for running heavy builds.
+
+* Provider: Hetzner
+* CPU: AMD Ryzen 7 1700X Eight-Core Processor
+* RAM: 64GB
+
+All the builds on this machine are pushed to https://nix-community.cachix.org/
+
+Thanks to Cachix for sponsoring our binary cache!
+
+## Usage
+
+* `./deploy` - NixOps deployment
+* ./terraform - Setup DNS
+