From e7966356a8d859d42fee7104edbb7433598368a7 Mon Sep 17 00:00:00 2001
From: Adrian Cochrane <adrian@openwork.nz>
Date: Thu, 11 Jul 2019 09:03:39 +1200
Subject: [PATCH] Update README.md

---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f035098..e9cace2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
-# rhapsode
+# Rhapsode
 
-Web browser targetting voice I/O.
\ No newline at end of file
+Web browser targetting voice I/O.
+
+## Desired Experience
+Rhapsode will read a webpage outloud to you according to some special CSS properties. Arrow key navigation will be supported for navigation between headings, paragraphs, and table cells.
+
+Links (defined generally enough to include `<audio>`, etc) will be indicated via a special beep for the user to repeat one back (via microphone or keyboard) at any time in order to navigate between pages. Rhapsode will start reading from the `<main>` element if present.
+
+Forms will be rendered as ordinary elements and be navigated to as a link. Once navigated to you will be prompted to fill each input of the form in turn before reviewing/correcting your submission before sending it.
+
+## Why?
+Because I want The Web to be "universal", for browsers to have the slack they need to present it however best suits their users and the devices they use. Rhapsode demonstrates HTML/CSS's capabilities this way.
\ No newline at end of file
-- 
2.30.2