# The Swap Shop
-This is a (very) simple PHP app for collecting a list of names in a random
-order. All of the magic happens in index.php.
+This is a little PHP app for collecting a list of names in a random order. All
+of the magic happens in index.php.
+
+It uses a sqlite database with two tables: one for "events" (called "swap
+lists" on the site), and one for "peeps" (the individual names in the lists).
+Each entry in the 'peeps' table has a name (shown on the page), and a random
+number generated when joining that's used to sort the list.
+
+And that's pretty much it! Creating a new swap list adds a new row to the
+events table, and joining a list adds a row to peeps.