diff --git a/README.md b/README.md
index a076a3a..83933a9 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,52 @@
-# cpe-calendar
-Sync your CPE calendar with your personal one
+<div align="center">
+  <img width=200 alt="logo cpe-calendar" src="/static/favicon.svg">
+
+  # CPE calendar
+
+  Sync your CPE calendar with your personal one.
+
+</div>
+
+# About
+
+The goal of the CPE Calendar is to offer students easy and effortless access to their school schedule by syncing it with their personal calendar. This works on all devices (phones, computers, laptops) and with any calendar provider, including Apple and Google.
+
+The calendar automatically updates every hour, keeping you informed of any schedule changes. This project is open-source, and contributions or issue reports are welcome on GitHub.
 
 # Setup
 
-1. Frist step is to setup your own `.env` use as reference `exemple.env`
-2.
-```
+1. The first step is to set up your own `.env` file. Use `example.env` as a reference.
+2. Then run the production version using Docker Compose.
+
+# Known Issues
+
+There can be an issue starting the Docker environment on Windows due to the missing `make-key.sh` script.
+
+# Development
+
+If you want to run the project without the Docker environment, follow these steps:
+
+### Generate the needed key
+```bash
 openssl genrsa -out secret/private.pem 2048
 openssl rsa -in secret/private.pem -pubout > static/public.pem
-```
\ No newline at end of file
+```
+
+### Start the code
+```bash
+go mod download
+go run main.go
+```
+
+# Trust
+
+As with all hosted open-source projects, there's no guarantee that the instance owner hasn't modified the official code. This implies a certain level of trust in the service chain. Depending on your trust level or risk tolerance, consider the following:
+
+1. **Full Trust**: Use the service as is.
+2. **Partial Trust**: Limit potential risks by creating a dedicated password for the service.
+3. **No Trust**: As this is an open-source project, you can host your own instance. A guide is available for setting it up.
+
+# Affiliation
+
+This project is entirely independent and is not affiliated with any school or organization.
+