diff --git a/threadr/README.md b/threadr/README.md
new file mode 100644
index 0000000..95db9e1
--- /dev/null
+++ b/threadr/README.md
@@ -0,0 +1,31 @@
+# Short documentation of each file
+### about [DIR]
+contains the about us page
+### board [DIR]
+contains the files needed to display a board
+### boards [DIR]
+contains the files for the board list
+### img [DIR]
+the directory that contains images that are part of the WebSite itself (no user content)
+### login [DIR]
+everything that is needed to log in a user
+### logout [DIR]
+the logout process
+### news [DIR]
+a page displaying a special board that is write-protected and shows updates about ThreadR
+### profile [DIR]
+profile pages and profile settings
+### signup [DIR]
+the signup process
+### userhome [DIR]
+the user’s feed
+### accept_cookie.php
+redirect immediately back to where tzhe user came from but sets a cookie that says 'You accept cookies.'
+$_GET variables:
+  * from: the url the user came from after urlencode() was used on it
+### index.php
+the homepage
+### README.md
+this file
+### style.css
+the stylesheet used on every ThreadR site