From 0670ca3d04af69b20829cfce3740976ced013fde Mon Sep 17 00:00:00 2001
From: Robert-André Mauchin <zebob.m@gmail.com>
Date: May 10 2024 15:24:26 +0000
Subject: Add documentation on how to bootstrap packages with Koji


Following the changes in 1.33.0:

https://docs.pagure.org/koji/release_notes/release_notes_1.33/#plugins

---

diff --git a/guidelines/modules/ROOT/pages/index.adoc b/guidelines/modules/ROOT/pages/index.adoc
index ef5650b..2d66e84 100644
--- a/guidelines/modules/ROOT/pages/index.adoc
+++ b/guidelines/modules/ROOT/pages/index.adoc
@@ -3096,9 +3096,11 @@ TIP: Since Fedora 30,
      the `+~bootstrap+` suffix is appended to the dist tag.
      This avoids the need to bump release
      between bootstrap and final build.
-     You can temporarily enable bootstrapping by commit,
-     which changes `+%bcond_with bootstrap+` to `+%bcond_without bootstrap+`
-     and later reverting the commit to do final build.
+     You can enable or disable bootstrapping by default by setting:
+     `+%bcond_without bootstrap+` (enabled by default) and
+     `+%bcond_with bootstrap+` (disabled by default)
+     then pass an option to Koji to switch the option according
+     to your need as explained in <<kojibootstrapping>>.
 
 TIP: Since Fedora 31,
      you can disable the automatic suffix addition
@@ -3120,6 +3122,44 @@ Please note that usage of pre-built binaries
 in bootstrap still needs an exception from the Packaging Committee
 as stated in <<General Exception Policy>>.
 
+[#kojibootstrapping]
+=== Using bootstrapping with Koji
+
+You can enable or disable the bootstrapping while building your package in a
+sidetag in Koji.
+
+First you should install `python3-koji-cli-plugins`
+
+[source, bash]
+----
+sudo dnf install python3-koji-cli-plugins
+----
+
+Then you need to request a sidetag where you will bootstrap your packages:
+
+[source, bash]
+----
+fedpkg request-side-tag --base-tag fXX-build
+----
+
+Wait for the sidetag to be created, then edit the sidetag to add the
+bootstrapping option:
+
+[source, bash]
+----
+koji edit-sidetag --rpm-macro _with_bootstrap=1 fXX-build-side-XXXXX
+----
+
+You can now build your packages with the bootstrap option. Once your
+bootstrapped packages are built, you can delete the option:
+
+[source, bash]
+----
+koji edit-sidetag --remove-rpm-macro _with_bootstrap fXX-build-side-XXXXX
+----
+
+And then build the unboostrapped versions.
+
 == System Cryptographic Policies
 
 Applications which make use the SSL or TLS cryptographic protocols