From 37cc7879a6b049670872fbbeb971060801596d95 Mon Sep 17 00:00:00 2001
From: Mikolaj Izdebski <mizdebsk@redhat.com>
Date: Apr 03 2017 12:43:48 +0000
Subject: Add branching SOP for Koschei


---

diff --git a/docs/sysadmin-guide/sops/koschei.rst b/docs/sysadmin-guide/sops/koschei.rst
index 4309edc..5db3fdd 100644
--- a/docs/sysadmin-guide/sops/koschei.rst
+++ b/docs/sysadmin-guide/sops/koschei.rst
@@ -201,3 +201,23 @@ To set static priority of package "foo" to value "100", run as
 koschei user::
 
   koschei-admin set-priority --static foo 100
+
+
+Adding new collection
+=====================
+After branching occurs and Koji build targets have been created,
+Koschei should be updated to reflect the new state.  This is done by
+renaming existing rawhide collection to branched and creating new
+rawhide collection.
+
+To rename "f26" collection to "Fedora 26", run as koschei user::
+
+  koschei-admin edit-collection f26 --display-name 'Fedora 26' --branch f26 --bugzilla-version 26
+
+Then create new "f27" collection by running:
+
+  koschei-admin create-collection f27 --display-name 'Fedora rawhide' --target f27 --build-group build --branch master --bugzilla-product Fedora --bugzilla-version rawhide
+
+Finally, add the new collection to "fedora" group:
+
+  koschei-admin edit-collection-group fedora --contents f26 f27