diff --git a/content/projects/debrepo.md b/content/projects/debrepo.md
index 6bbb867..6793b92 100644
--- a/content/projects/debrepo.md
+++ b/content/projects/debrepo.md
@@ -7,33 +7,39 @@ description = "Lightweight tool to create and manage Debian APT repositories"
 state = "stable"
 +++
 
-**Debrepo** is a lightweight tool for creating and managing Debian repositories for `*.deb` packages — a simple alternative to heavier tools like `reprepro` or `aptly`.
+**Debrepo** is a lightweight tool for creating and managing Debian repositories for `*.deb` packages. It was built with simplicity in mind as an alternative to heavier tools like `reprepro` or `aptly`.
+
+The main motivation behind **debrepo** was to support **multiple versions** of the same package in a single repository, something standard `reprepro` configurations often struggle with, using standard Debian tools.
 
 #### **Key Features:**
-* **Init repository structure** (`debrepo init`)
-* **Add / delete packages** (`debrepo add`, `debrepo del`)
-* **List packages** (`debrepo list`)
-* **Built-in static serving** for quick testing (`debrepo serve`)
-* **Minimal deps:** `sh`, `dpkg`, `gpg`, `python3`
+* **Minimal Dependencies:** `bash`, `dpkg-dev`, `gpg`, `python3`.
+* **Multi-version Support:** Keeps history of package versions automatically.
+* **GPG Signing:** Automatically signs releases using your GPG key.
+* **Built-in Server:** Includes a Python HTTP server for instant testing (`debrepo serve`).
+
+#### **Quick Usage**
 
-#### **Quick usage**
 ```bash
-# create repo structure
-debrepo init /path/to/repo
+# 1. Install (Clone & Symlink)
+git clone [https://github.com/filiprojek/debrepo.git](https://github.com/filiprojek/debrepo.git)
+sudo ln -s $(pwd)/debrepo/debrepo.sh /usr/bin/debrepo
 
-# add a package
-debrepo add ./build/foo_1.0_amd64.deb
+# 2. Initialize repository
+mkdir my-repo && cd my-repo
+debrepo init --repodir .
 
-# list & remove
-debrepo list
-debrepo del foo_1.0_amd64
+# 3. Configure (Set your GPG key and Origin)
+# Create the configuration file: apt-repo/config
 
-# serve locally (for testing)
-debrepo serve
-````
+# 4. Add a package
+debrepo add ./build/foo_1.0_amd64.deb --repodir ./path/to/repo
+
+# 5. Serve locally (for testing)
+debrepo serve --repodir ./path/to/repo
+
+```
 
 Find the source here:
 
-* Primary (Gitea): [https://git.filiprojek.cz/fr/debrepo](https://git.filiprojek.cz/fr/debrepo)
-* GitHub (mirror): [https://github.com/filiprojek/debrepo](https://github.com/filiprojek/debrepo)
+* GitHub: [https://github.com/filiprojek/debrepo](https://github.com/filiprojek/debrepo)