1 files changed, 15 insertions, 2 deletions
diff --git a/README.md b/README.md
index a021da0..e72f6c1 100755
--- a/README.md
+++ b/README.md
@@ -1,2 +1,15 @@
-Mips CPU
-========
+# Mips CPU
+
+MIPS I simulator written in C++.
+
+## Build
+
+To build the cpu, the [`makefile`](/makefile) can be used.
+
+``` shell
+# Building
+make
+
+# Running tests
+./src/ymh15/test_mips
+```