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