Update README.md
diff --git a/README.md b/README.md
index e144388..abdce6d 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,34 @@
-# Caravel User Project
+# Hack SoC
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![UPRJ_CI](https://github.com/efabless/caravel_project_example/actions/workflows/user_project_ci.yml/badge.svg)](https://github.com/efabless/caravel_project_example/actions/workflows/user_project_ci.yml) [![Caravel Build](https://github.com/efabless/caravel_project_example/actions/workflows/caravel_build.yml/badge.svg)](https://github.com/efabless/caravel_project_example/actions/workflows/caravel_build.yml)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
## Hardware implementation of the Hack Computer from the Nand to Tetris courses
+![HACK Computer](docs/caravel_hack_soc-COVER-con-logo.jpg)
+
+![HACK Computer](docs/project.jpg)
+
+
+---
+### HACK Computer
+Official website of Nand to Tetris courses:
+https://www.nand2tetris.org/
+
+Some details of the original HACK Computer:
+```
+HACK
+16bit Computer
+Harvard architecture: separate Program & Data memory
+32 KBytes ROM
+32 KBytes Addressable RAM:
+ 16 KBytes GENERAL RAM
+ 8 KBytes VRAM
+ 1 Bytes Keyboard input memory map
+```
+
+---
+
+
+This repository is based on the example caravel_user_project.
Refer to [README](docs/source/quickstart.rst) for a quick start of how to use caravel_user_project
diff --git a/docs/caravel_hack_soc-COVER-con-logo.jpg b/docs/caravel_hack_soc-COVER-con-logo.jpg
new file mode 100644
index 0000000..9813224
--- /dev/null
+++ b/docs/caravel_hack_soc-COVER-con-logo.jpg
Binary files differ
diff --git a/docs/project.jpg b/docs/project.jpg
new file mode 100644
index 0000000..e0670cf
--- /dev/null
+++ b/docs/project.jpg
Binary files differ