From fbbe881bec3a5fe8c3344899c8c1a09fd92af25e Mon Sep 17 00:00:00 2001
From: Devine Lu Linvega <aliceffekt@gmail.com>
Date: Thu, 17 Sep 2020 12:11:40 -0700
Subject: [PATCH] Improved docs

---
 README.md | 36 +++++++++++++++++++-----------------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index 4f1d8f7..ad4883b 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,28 @@
 # Parade
 
-This simple implementation incorporates the basic primitives.
+In Paradise, you are but a force acting upon places, objects, words — vessels. Parade is a subset of the Paradise interactive fiction engine designed explicitly to explore the possible interactions available within the primitives.
 
-```
-create a teapot
-become the teapot
-enter the ghost
-leave
+### Basic commands
 
-take the ghost
-drop the ghost
-warp in the teapot
-transform into a bat
+- create a teapot
+- become the teapot
+- enter the ghost
+- leave
 
-note the bat is dark.
-program create a teapot
-warp to the library
-become the ghost
+### Controls commands
 
-use the bat ; should create a teapot
-```
+- take the ghost
+- drop the ghost
+- warp in the teapot
+- transform into a bat
+
+### Narrative commands
+
+- note the bat is dark.
+- program create a teapot
+- warp to the library
+- use the bat
 
 ## Save/Load
 
-To save a world, use `@save filename.txt`, to load `@load filename.txt`, to quit `@quit`.
+To save a world, use `@save filename.txt`, to load `@load filename.txt`, to quit `@quit`. You can learn more about Parade [here](https://wiki.xxiivv.com/site/parade.html).