diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..de422d8
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+build
+.DS_Store
+.vscode
\ No newline at end of file
diff --git a/README.md b/README.md
index a8537b1..058d38a 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,13 @@
 # Rough_surface_generation_and_viscoelastic_contact
 
+
+This repository contains Jupyter notebooks and related materials focused on the generation of rough surfaces and the study of contact area evolution between self-affine viscoelastic rough surfaces. 
+
+The work presented here is closely related to the [master thesis of Zichen Li](https://likeable-silverfish-7a2.notion.site/Master_thesis-1708839faff780c3834fd0a34f90c6ee), conducted under the supervision of Lucas Frérot and Renald Brenner at D'Alembert Institute. 
+
+Key topics covered include:
+- **Rough Surface Generation**: Implementation of algorithms for creating self-affine surfaces with controlled statistical properties.
+- **Contact Area Evolution**: Analysis of the dynamic changes in contact areas under varying loading conditions, incorporating viscoelastic material behavior.
+
+
+Feel free to explore the notebooks, and don't hesitate to contribute or raise issues if you have suggestions or questions!
\ No newline at end of file