diff --git a/README.md b/README.md
new file mode 100644
index 00000000..83e79857
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# Portfolio
+
+This repository is related to the course [[Portfolio Website Tutorial – Frontend Development with HTML, CSS, JavaScript](https://www.youtube.com/watch?v=xV7S8BhIeBo&t)] available on the freeCodeCamp's YouTube channel.
+
+## Description
+In this course, you will learn how to build a portfolio website using JavaScript, HTML, and CSS. This is a great project to improve you frontend development skills.
+
+✏️ MacLinz developed this course course. Check out his [channel](https://www.youtube.com/c/MacLinzUniversalChannel).
+
+## ⚠️ Important notice
+The current version of this repository can contain code which differs from the original code shown in the video. The code has been improved or customized by [Dyrits](https://github.com/Dyrits), adding semantic elements, and a more optimized JavaScript script, but the visual rendering of the portfolio remains globally the same.
+
+The original code is available [here](https://github.com/Maclinz/JS_CSS_PortfolioProject/tree/1f1c0205c0b3a8caa623c96402775974f39ab5cb).
+
+### Main differences from the original
+- Multiple scripts have been added to the code, including data objects that can be filled in order to automatically generate some elements.
+- The stylesheets have been divided in multiple partial files, each one containing a specific style for a specific section.
+- A lot of identifiers and class names have been modified.
+- The tiles in the portfolio and blog section have been modified, in order to have a fixed size.
+- The breakpoints for the media queries have been modified.
+- The sections are displayed differently with different titles, and are all centered on smaller screens.
+
+## Changelog
+
+### Last updates [06/05/2022-20/05/2022]
+The portfolio is now responsive.
+It is now possible to add new articles for the blog section in the dedicated object in the `data/articles.js`, generating automatically the tiles.
+It is now possible to add new projects for the portfolio section in the dedicated object in the `data/projects.js`, generating automatically the tiles.
+It is now possible to add new skills for the about section in the dedicated object in the `data/skills.js`, generating automatically the progression bars.
+
+### Update [06/05/2022]
+It is now possible to add new skills in the dedicated object in the `stastistics.js`, generating automatically new progression bars. The label of the progression bars has been replaced by an icon.
\ No newline at end of file
diff --git a/img/blog1.jpg b/images/blog/blog1.jpg
similarity index 100%
rename from img/blog1.jpg
rename to images/blog/blog1.jpg
diff --git a/img/blog2.jpg b/images/blog/blog2.jpg
similarity index 100%
rename from img/blog2.jpg
rename to images/blog/blog2.jpg
diff --git a/img/blog3.jpg b/images/blog/blog3.jpg
similarity index 100%
rename from img/blog3.jpg
rename to images/blog/blog3.jpg
diff --git a/img/port1.jpg b/images/blog/port1.jpg
similarity index 100%
rename from img/port1.jpg
rename to images/blog/port1.jpg
diff --git a/img/port3.jpg b/images/blog/port3.jpg
similarity index 100%
rename from img/port3.jpg
rename to images/blog/port3.jpg
diff --git a/img/port6.jpg b/images/blog/port6.jpg
similarity index 100%
rename from img/port6.jpg
rename to images/blog/port6.jpg
diff --git a/img/hero.png b/images/hero.png
similarity index 100%
rename from img/hero.png
rename to images/hero.png
diff --git a/images/portfolio/port1.jpg b/images/portfolio/port1.jpg
new file mode 100644
index 00000000..b19d9619
Binary files /dev/null and b/images/portfolio/port1.jpg differ
diff --git a/img/port2.jpg b/images/portfolio/port2.jpg
similarity index 100%
rename from img/port2.jpg
rename to images/portfolio/port2.jpg
diff --git a/images/portfolio/port3.jpg b/images/portfolio/port3.jpg
new file mode 100644
index 00000000..e7ff37eb
Binary files /dev/null and b/images/portfolio/port3.jpg differ
diff --git a/img/port4.jpg b/images/portfolio/port4.jpg
similarity index 100%
rename from img/port4.jpg
rename to images/portfolio/port4.jpg
diff --git a/img/port5.jpg b/images/portfolio/port5.jpg
similarity index 100%
rename from img/port5.jpg
rename to images/portfolio/port5.jpg
diff --git a/images/portfolio/port6.jpg b/images/portfolio/port6.jpg
new file mode 100644
index 00000000..f5888fc0
Binary files /dev/null and b/images/portfolio/port6.jpg differ
diff --git a/img/port7.jpg b/images/portfolio/port7.jpg
similarity index 100%
rename from img/port7.jpg
rename to images/portfolio/port7.jpg
diff --git a/index.html b/index.html
index b3b2136c..e7342de3 100644
--- a/index.html
+++ b/index.html
@@ -5,559 +5,253 @@
Portfolio
-
-
+
+
+
+
+
+
-
-
-
-
-
-
+
+
+
+
+
+
-
-
-
- Hi, I'm Solano Milan Diaz.
- A Web Developer.
-
+
+
+
Hi, I'm Solano Milan Diaz, a Web Developer.
- I'm a Web Developer, I love to create beautiful and functional websites.
- Lorem ipsum dolor sit amet consectetur adipisicing elit. Officia, libero?
- Lorem ipsum dolor sit amet consectetur adipisicing elit. Neque blanditiis sed aut!
+ I'm a Web Developer, I love to create beautiful and functional websites.
+ [This part can be filled with additional information.]
- Lorem ipsum dolor sit amet consectetur adipisicing elit.
- Eveniet labore nihil obcaecati consequatur. Debitis error doloremque,
- vero eos vel nemo eius voluptatem dicta tenetur modi.
La musica
- delectus dolore fugiat exercitationem a,
- ipsum quidem quo enim natus accusamus labore dolores nam. Unde.
- Lorem ipsum dolor sit amet consectetur, adipisicing elit.
- Harum non necessitatibus deleniti eum soluta.
+ [This part will be filled with information.]
+
+ Lorem ipsum dolor sit amet, consectetur adipisicing elit. Deserunt id in natus nihil rem rerum.
+
+ Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aspernatur deserunt, exercitationem illo quae quis rerum?