From 14d8b9810083b54a4d5c63c11e7989d6c7eae99b Mon Sep 17 00:00:00 2001
From: Sandro CURY CAZZANIGA <sandro@cazzaniga.fr>
Date: Mon, 24 Nov 2025 09:56:31 +0100
Subject: [PATCH] docs: update readme

---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 66 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e9610fe..851a686 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,67 @@
-# advent-of-code
+# Advent of Code
 
-My advent of code solutions
\ No newline at end of file
+Personal solutions for [Advent of Code](https://adventofcode.com/), all implemented in Go.
+
+The goal is to practice programming and problem-solving habits while keeping each day's solution self-contained and easy to revisit later.
+
+It uses pure Go, no external dependencies.
+
+## Requirements
+
+- Go 1.25
+- Puzzle input
+
+## Repository Structure
+
+```
+yyyy/
+├── dayXX/
+│   ├── main.go      # The main code to run to print solutions.
+│   ├── main_test.go # The test file that validates the logic.
+│   └── input.txt    # The day's puzzle input.
+└── ...
+```
+
+Each day's code can be run with:
+
+```bash
+cd yyyy/dayXX
+go run main.go
+```
+
+Expected output:
+
+```bash
+Part 1: <answer>
+Part 2: <answer>
+```
+
+## Tests
+
+In the Advent of Code, every day the logic is explained with a sample result, like this:
+
+```
+For example:
+
+1abc2
+pqr3stu8vwx
+a1b2c3d4e5f
+treb7uchet
+
+In this example, the calibration values of these four lines are 12, 38, 15, and 77.
+
+Adding these together produces 142.
+```
+
+I'm using these examples to validate my logic.
+
+If you want to run those, you can use:
+
+```bash
+cd dayXX
+go test
+```
+
+## Notes
+
+Happy coding, and good luck on the puzzles!