From db7f0ad9db2fdb0c961a50017ef0dcd185ff9e24 Mon Sep 17 00:00:00 2001
From: William Petit <wpetit@cadoles.com>
Date: Thu, 3 Apr 2025 14:16:14 +0200
Subject: [PATCH] feat(gitea): add mkt-gitea-package task documentation

---
 doc/tasks/gitea.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/doc/tasks/gitea.md b/doc/tasks/gitea.md
index cd00852..3330fac 100644
--- a/doc/tasks/gitea.md
+++ b/doc/tasks/gitea.md
@@ -22,4 +22,25 @@ MKT_GITEA_RELEASE_BODY ?= My new release
 # des fichiers à téléverser avec la nouvelle version publiée
 my-release:
 	$(MAKE) MKT_GITEA_RELEASE_ATTACHMENTS="$$(find dist/* -type f -printf '%p ')" mkt-gitea-release
-```
\ No newline at end of file
+```
+
+## `make mkt-gitea-package`
+
+La tâche `mkt-gitea-package` permet de téléverser des paquets (voir https://docs.gitea.com/usage/packages/overview/) dans une organisation Gitea.
+
+### Usage
+
+Exemple d'utilisation de la tâche pour le téléversement de paquets `dist/mypackage.deb` sur le projet factice `my-org/my-project` sur https://forge.cadoles.com.
+
+```makefile
+# Organisation Gitea du projet
+MKT_GITEA_PACKAGE_ORG ?= my-org
+# Projet Gitea
+MKT_GITEA_PACKAGE_PROJECT ?= my-project
+
+# Exécution de la tâche mkt-gitea-package en passant le chemin du paquet à téléverser
+upload-package:
+	$(MAKE) MKT_GITEA_PACKAGE_FILE="dist/mypackage.deb" mkt-gitea-package
+```
+
+Voir le script [`gitea-package.sh`](https://forge.cadoles.com/Cadoles/Jenkins/src/branch/master/resources/com/cadoles/gitea/gitea-package.sh) pour plus d'informations sur les variables d'environnement disponibles.