From 26e9dd45937136187b0a1b6bb75c9f7526b37ba7 Mon Sep 17 00:00:00 2001
From: Wynn Wolf Arbor
Date: Sun, 31 May 2020 19:35:06 +0200
Subject: README: Reword introduction and include links to relevant resources

---
 README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index ffa0751..1748611 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,12 @@
 # skein - secure cgit hosting with slowcgi(8)
 
-This is a small collection of utilities needed for managing a secure and
-extensible deployment of cgit using OpenBSD's slowcgi(8).
+skein is a [framework](skein.7) for managing a secure and extensible deployment
+of [cgit](https://git.zx2c4.com/cgit/about/) using OpenBSD's slowcgi(8). It
+also includes a few small helper utilities.
 
 ## Utilities
 
-- skein-infra - set up skein's cgit chroot infrastructure
+- [skein-infra(8)](skein-infra.8) - set up skein's cgit chroot infrastructure
 - cgit-about-filter - a C implementation of a simple about-filter for
-  cgit using mandoc(1) and lowdown(1).
+  cgit using [mandoc(1)](https://mandoc.bsd.lv/) and
+  [lowdown(1)](https://kristaps.bsd.lv/lowdown/).
-- 
cgit v1.2.3-2-gb3c3