diff --git a/README.md b/README.md
index 2961e6f..948586c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,55 @@
 # DEC-foundations-of-python
-Materials for the course Foundations of Python for Data Science, created and maintained by DEC
+
+This repository contains all the material for the DEC Python training.
+This training is developed by DIME Analytics and DECDG.
+
+## Course content
+
+This training is structured into three parts.
+Part 0 is a single session introduction for people with no coding background.
+Part 1 is a course that covers the foundations of Python
+used in almost any type of Python data science project.
+Part 2 is a collection of stand alone sessions that
+assumes knowledge in the foundations of Python
+and each session dives deeper into the advanced topic.
+
+#### Links to content
+* **Part 0 - Intro to Programming**
+  * [Slides](https://github.com/worldbank/dec-python-course/blob/main/0-intro-to-programming/0-intro-to-programming.pdf)
+* **Part 1 - Foundations of Data Science in Python**
+    * Session 1 - Variable types and Python syntax
+        * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/1-types-and-syntax/foundations-s1.ipynb)
+        * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/1-types-and-syntax/foundations-s1.ipynb)
+        * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/1-types-and-syntax/solutions-s1.ipynb)
+    * Session 2 - Control flow and functions
+        * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/2-control-flows-and-functions/foundations-s2.ipynb)
+        * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/2-control-flows-and-functions/foundations-s2.ipynb)
+        * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/2-control-flows-and-functions/solutions-s2.ipynb)
+    * Project 1 - Schelling model
+        * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/project-1-schelling-model/project-1-schelling-model-of-segregation.ipynb)
+        * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/project-1-schelling-model/project-1-schelling-model-of-segregation.ipynb)
+        * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/project-1-schelling-model/project1-solutions.ipynb)
+    * Session 3 - NumPy and Pandas
+        * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/3-numpy-and-pandas/foundations-s3.ipynb)
+        * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/3-numpy-and-pandas/foundations-s3.ipynb)
+        * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/3-numpy-and-pandas/solutions-s3.ipynb)
+    * Session 4 - APIs and introduction to data visualization in Python
+        * APIs
+            * [Slides](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/Introduction%20to%20APIs.pdf)
+            * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-api.ipynb)
+            * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-api.ipynb)
+            * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-api-solutions.ipynb)
+        * Data visualization
+            * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-dataviz.ipynb)
+            * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/4-api-and-dataviz/foundations-s4-dataviz.ipynb)
+    * Project 2 -
+        * [Jupyter notebook](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/project-2-rasters_and_functions/Project%202.ipynb)
+        * [Colab notebook](https://colab.research.google.com/github/worldbank/dec-python-course/blob/main/1-foundations/project-2-rasters_and_functions/Project%202.ipynb)
+        * [Suggested solutions](https://github.com/worldbank/dec-python-course/blob/main/1-foundations/project-2-rasters_and_functions/Project%202_Solutions.ipynb)
+* **Part 2 - Advanced topics of Data Science of Python**
+    * Not developed yet
+
+## Contact
+
+If you have any questions you can contact one of the teams behind this training
+on dimeanalytics@worldbank.org.