diff --git a/README.md b/README.md
index 7d77977..ada9ae9 100644
--- a/README.md
+++ b/README.md
@@ -2,21 +2,47 @@
 
 This project was started in April 2022 and the objective of this project was to restore an exterior electric gate that had not worked for over 15 years.
 
-### Table of contents
+## Table of contents
 
 [[_TOC_]]
 
-### Context
-In my yard, there has always been an electric gate that I have seen work very few times, if ever.
+## Context
+In my backyard, there has always been an electric gate that I have rarely, if ever, seen work.
 
-I decided to repair it as I felt I had the DIY and electronic skills to get it working again.
+I decided to fix it because I thought I had the DIY and electronic skills to make it work again.
 
-This courtyard gives access to different houses and the access to it is therefore shared. This implies that the operation of the latter must be low, easy and without constraint.
+This gate gives access to different houses and therefore its access is shared. This implies that its operation should be low, easy and unencumbered.
 
-### Choice of technologies
+It has not worked for about fifteen years since it requires a 230V three-phase power supply. The subscription was cancelled to have only single-phase and the gate remained open since that day.
 
-#### Hardware
+## Before anything
 
-For this project, I had the opportunity to make my own electronic board in order to build a reliable, clean and easy to install system.
+The state of the portal before starting my project was as follows:
+- A three-phase motor that needs to run on single-phase (conversion required).
+- Mechanical limit switches to be changed
+- A broken photoelectric sensor to be changed
+- The electronics of the gate to be completely redone
 
-See : [LiHoCo Yard gate PCB v1.0](hardware/PCB/yard_gate_pcb_v1.0.md)
+## Required elements
+
+### Hardware
+
+For this project, I made an electronic board to build a reliable, clean and easy to install system: [LiHoCo Yard gate PCB v1.0](hardware/PCB/yard_gate_pcb_v1.0.md)
+
+I also needed other components such as:
+- [Mechanical limit switches](https://www.conrad.fr/fr/p/interrupteur-de-fin-de-course-tru-components-xz-9-108-1426610-250-v-ac-10-a-levier-pivotant-a-galet-a-rappel-ip65-1-pc-s-1569253.html)
+- [Photoelectric sensor](https://fr.aliexpress.com/item/32810795246.html)
+- [Warning light](https://fr.aliexpress.com/item/1005002878506861.html)
+- [433MHz RF remote control](https://fr.aliexpress.com/item/1005003238379943.html)
+- Junction box
+- Cable
+
+### Software
+
+[ESPhome](https://esphome.io/) was the easiest solution to implement the portal system. I used it to make my ESP32 program
+
+## Points of improvement
+
+### Security : No rolling code
+
+The EV1527 433MHz receiver module does not allow code rolling as the HCS301 KeeLoq protocols do. Nevertheless, since the gate does not give any access to the interior of a house, this point does not really pose a problem.
\ No newline at end of file