diff --git a/README.md b/README.md
index f7ce11a..6332599 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # nicethings
 
-A program for shared unix servers, specifically [tilde.town](https://tilde.town), to cheer people up .
+A program for shared Unix servers, specifically [tilde.town](https://tilde.town), to cheer people up .
 
 # Table of Contents
 <!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
@@ -12,9 +12,11 @@ A program for shared unix servers, specifically [tilde.town](https://tilde.town)
 
 # How it works
 
-Users collaborate by adding or removing nice messages to their own
-list, where the messages are combined and then displayed at random by
-any user.
+Each user on the shared Unix server may have a `.nicethings` file. The
+`.nicethings` file may be populated with a list of nice messages
+created by a user. All users' `.nicethings` files are converted to
+lists. All lists are combined into one list. A random nice message is
+picked from from this list and is displayed to the user.
 
 ## How it works in detail