diff --git a/smallsh/readme.md b/smallsh/readme.md
new file mode 100644
index 0000000..cfc998d
--- /dev/null
+++ b/smallsh/readme.md
@@ -0,0 +1,42 @@
+
+# smallsh
+
+This is an interactive shell called smallsh! It should be similar
+to other shells you have used, but fallowing a minimalist approach:
+aka a ton of features are missing. You got comfortable with pipes and
+other fancy time-saving features; but for smallsh, we believe those 
+take away from the pure nature of typing into your computer and that
+we should go back to a world without.
+
+
+## Compiling
+
+You can compile this program by using the make command or by hand.
+
+Simply type:
+
+```
+make
+```
+
+or, to manually compile, type: 
+
+```
+gcc -std=c99 main.c -o movies_by_year
+```
+
+## Running
+
+To run, type:
+
+```
+make run
+```
+
+or
+
+```
+./smallsh
+```
+
+to run manually