diff --git a/README.md b/README.md
index e69de29..5244df5 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,21 @@
+# The Projects
+
+This project can be ran by calling:
+
+``` shell
+cargo run
+```
+or can just be compiled under the 'target' directory by calling:
+
+``` shell
+cargo build
+```
+
+---
+the projects from the Rust Book under the lesson 'control flow'
+* Convert temperatures between Fahrenheit and Celsius
+* Generate the nth Fibonacci number
+* Print th elyrics to the christmas carol "The Twelve Days of Christmas", taking advantage of the repetition in the song.
+
+
+mostly just a test repo.