From f5bd7b882266cc52564f63ae02af4d0de446b313 Mon Sep 17 00:00:00 2001
From: Matteo Croce <teknoraver@meta.com>
Date: Mar 24 2025 14:53:49 +0000
Subject: add RPM CoW documentation


---

diff --git a/docs/content/repositories/experimental.md b/docs/content/repositories/experimental.md
index 9205c34..0f08a75 100644
--- a/docs/content/repositories/experimental.md
+++ b/docs/content/repositories/experimental.md
@@ -15,10 +15,22 @@ packages on our
 [package-bugs](https://pagure.io/centos-sig-hyperscale/package-bugs) tracker.
 
 ## DNF/RPM stack with CoW support
-An updated packaging stack (`rpm`, `dnf`, `libdnf`, `librepo`) is available in
-the repository. These packages include several improvements and bugfixes to
-support the ongoing
-[Copy-on-Write](https://fedoraproject.org/wiki/Changes/RPMCoW) work.
+CentOS Hyperscale SIG is working on enabling Copy-on-Write (CoW) support in
+the DNF/RPM stack. This is currently present in the experimental repository
+but not enabled by default.  
+To actually use it, you need to install the packages `rpm-plugin-reflink` and
+`python3-dnf-plugin-cow`.
+
+Then CoW must be enabled by putting this in `/etc/dnf/plugins/reflink.conf`
+
+```ini
+[main]
+enabled=1
+```
+
+The only supported filesystems are `BtrFS` and `XFS` at the moment.  
+More informations about this work can be found at:
+[Copy-on-Write](https://fedoraproject.org/wiki/Changes/RPMCoW).
 
 ## Kernel
 We have a 5.12.4 release of the [Linux kernel](https://kernel.org) currently