diff --git a/README.md b/README.md
index 5a9c392..2132058 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,26 @@
 # Projectjava
 
+The Project folder is 'gameoflife'
+
+The required method were filled, methods for the new gamemodes were added, methods were modified.
+
+Two game modes were added:
+Two Population: red cells and blue cells can be set using either a toggle or left / right click.
+                a cell that comes alive or stays alive takes the state of the dominant neighbour.
+HigHLife: cells come alive if neighbours==3 or 6
+
+The visual aspect of the interface was changed to a red and black retro style, the font also was changed.
+A complex welcome screen was introduced.
+A music is toggled by pressing the togglesound button.
+The generate random button sets random blue or red state for the Two Population game
+Some .csv files were added (amongus_dessin is great, replicator is used to check that the higlife mode works properly)
+
+Three classes were added:
+MusicPlayer.java: plays the music we chose
+WelcomeScreen.java: displays a welcome screen with a button to access the simulation
+GameOfLifeSimulation.java: simulates a game of life with random step 0 cells that is used as background of WelcomeScreen.java
+
+Tips:   Play in full screen to have access to all the button
+        Play with the music on
+
+Authors: Estevan Biau-Loyer / Alexis Couesnon / Darren Gallois
\ No newline at end of file