fix(debrepo.md): enhance project description and add key features and usage examples

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
+**Debrepo** is a lightweight tool for creating and managing Debian repositories for `*.deb` packages — a simple alternative to heavier tools like `reprepro` or `aptly`.
-A Debian repository management tool.
 
-## About
+#### **Key Features:**
-`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.
+* **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
+#### **Quick usage**
-- [Git](https://git.filiprojek.cz/fr/debrepo)
+```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)