From eb2bd6413d5328f97807e629ddce6f1cfa3b4fcb Mon Sep 17 00:00:00 2001
From: Filip Rojek <filip@filiprojek.cz>
Date: Wed, 27 Aug 2025 13:43:45 +0200
Subject: [PATCH] fix(debrepo.md): enhance project description and add key
 features and usage examples

---
 content/projects/debrepo.md | 35 ++++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/content/projects/debrepo.md b/content/projects/debrepo.md
index ed97968..6bbb867 100644
--- a/content/projects/debrepo.md
+++ b/content/projects/debrepo.md
@@ -1,18 +1,39 @@
 +++
 title = "Debrepo"
 date = 2023-05-01
-description = "A Debian repository management tool"
+description = "Lightweight tool to create and manage Debian APT repositories"
 
 [extra]
 state = "stable"
 +++
 
-# Debrepo
-A Debian repository management tool.
+**Debrepo** is a lightweight tool for creating and managing Debian repositories for `*.deb` packages — a simple alternative to heavier tools like `reprepro` or `aptly`.
 
-## About
-`Debrepo` is a software tool designed for creating and managing Debian repositories for `*.deb` packages, providing a lightweight and user-friendly alternative to more complex tools like `reprepo` or `aptly`. While these alternatives may offer more advanced features, Debrepo focuses on providing essential functionality and ease of use for repository management, allowing users to easily add, remove, and update packages within their repositories. With Debrepo, users can efficiently manage their Debian repositories without the unnecessary complexity of more advanced 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`
 
-## Links
-- [Git](https://git.filiprojek.cz/fr/debrepo)
+#### **Quick usage**
+```bash
+# create repo structure
+debrepo init /path/to/repo
+
+# add a package
+debrepo add ./build/foo_1.0_amd64.deb
+
+# list & remove
+debrepo list
+debrepo del foo_1.0_amd64
+
+# serve locally (for testing)
+debrepo serve
+````
+
+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)