Improve README

1 files changed, 36 insertions, 9 deletions

diff --git a/README.md b/README.md
index ae239a5..7789ac3 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,43 @@
-# hugo-theme-journal
-An accessible, no-JS, minimalist, high-contrast Hugo theme that outputs Gemtext and HTML. Suitable for blogs.
+# Journal Theme For Hugo
 
-## Clone to Your Theme Directory
-```bash
+Hugo Journal Theme is an accessible, no-JS, minimalist, high-contrast Hugo theme that outputs Gemtext and HTML. It's suitable for blogs.
+
+## Demo
+
+A live demo of the theme can be found at the following domain: [https://nicholasjohnson.ch](https://nicholasjohnson.ch)
+
+## Features
+
+* Outputs Gemtext for the [Gemini protocol](https://gemini.circumlunar.space/docs/specification.gmi)
+* 100⁄100 Google Lighthouse score
+* Looks good on all screen sizes
+* No bloated Javascript
+* Absolutely no analytics
+
+## Get The Theme
+
+Run from the root of your Hugo site:
+
+```sh
 $ git clone https://git.nicholasjohnson.ch/hugo-theme-journal themes/journal
 ```
 
-## Generate The Blog
-In order to render the blog in Gemini and Web format, it's best to render it with separate configuration files. Have a look at [my journal repo](https://git.nicholasjohnson.ch/journal) for an example.
+Alternatively, if your Hugo site is version controlled, clone this theme as a git submodule:
+
+```sh
+$ git submodule add https://git.nicholasjohnson.ch/hugo-theme-journal themes/journal
+```
+
+## Generate The Site
+
+To render the blog for Gemini and the Web, use separate configuration files. For guidance, look at [my journal repo](https://git.nicholasjohnson.ch/journal).
+
+The [Gemtext compatibility document](/GEMTEXT-COMPATIBILITY.md) explains which Markdown can be safely converted to Gemini.
+
+## Versioning
+
+This Hugo theme uses [Semantic Versioning 2.0.0](https://semver.org/).
 
 ## License
-GPLv3 or later
 
-## Version
-This Hugo theme uses [semantic versioning](https://semver.org/) with Git tags.
+Hugo Journal Theme is licensed under [GPLv3 or later](/LICENSE).