diff --git a/README.md b/README.md
index 95c83a4..5ef7c91 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,13 @@
-# Names of the students in the group:
-- Tristan Barjavel
-- Théo Lemaire
+## Description
+
+This repo contains homework assignments of **Tristan Barjavel** and **Théo Lemaire** for the course *Scientific Programming for Engineers* (fall 2018).
+
+Below instructions on how to run the code for each assignment assume that this repository has been properly cloned beforehand.
+
+## How to run the code for homework 1 (week 4)
 
-# How to run the code for homework 1 (week 4):
 - Open a terminal to the root of the repository
+- Pull the latest content from the remote repository: `git pull`
 - Move to the appropriate subfolder: `cd work/week4/conjugate_gradient`
 - To execute part 1: `python optimizer.py`
 - To execute part 2: `python conjugate_gradient.py`