From f84fff11f5817ded3911daec9c59a1b3a89f2f4c Mon Sep 17 00:00:00 2001
From: Tomas Kopecek <tkopecek@redhat.com>
Date: Jul 02 2024 11:02:11 +0000
Subject: PR#4104: Add external koji dev environments' links


Merges #4104
https://pagure.io/koji/pull-request/4104

Fixes: #1558
https://pagure.io/koji/issue/1558
Create a basic Vagrant development environment

---

diff --git a/docs/source/writing_koji_code.rst b/docs/source/writing_koji_code.rst
index 8f784aa..3602896 100644
--- a/docs/source/writing_koji_code.rst
+++ b/docs/source/writing_koji_code.rst
@@ -625,6 +625,22 @@ kojira is a daemon that keeps the build root repodata updated. It is
 responsible for removing redundant build roots and cleaning up after a
 build request is completed.
 
+Development Environment
+=======================
+
+Best development environment would be to install koji as expected via
+:doc:`server_howto`. This would leave you with fully functional environment
+able to build everything koji can. Also, it is a good exercise to understand
+how all the parts interact. Of course, it is time consuming, so various people
+created following environments:
+
+ * Vagrant environment with ansible provisioning:
+   https://github.com/ktdreyer/koji-playbooks/tree/master/vagrant
+ * Light container-based environment (e.g. can't build images):
+   https://github.com/tkopecek/koji-container-dev
+ * Vagrant-based: https://pagure.io/koji-vagrant
+ * Vagrant-based: https://pagure.io/koji/pull-request/420
+
 Building and Deploying Changes
 ==============================