From 6dbbebfd45752b2e5502f3ffda6cf4d7d79f878f Mon Sep 17 00:00:00 2001
From: Michal Konecny <mkonecny@redhat.com>
Date: Thu, 9 Nov 2023 12:21:04 +0100
Subject: [PATCH] Add Bodhi document to dist-git investigation

Include Bodhi investigation to dist-git decoupling ARC document

Signed-off-by: Michal Konecny <mkonecny@redhat.com>
---
 docs/dist-git-move/bodhi.rst | 43 ++++++++++++++++++++++++++++++++++++
 docs/dist-git-move/index.rst |  1 +
 2 files changed, 44 insertions(+)
 create mode 100644 docs/dist-git-move/bodhi.rst

diff --git a/docs/dist-git-move/bodhi.rst b/docs/dist-git-move/bodhi.rst
new file mode 100644
index 0000000..c1f5b6d
--- /dev/null
+++ b/docs/dist-git-move/bodhi.rst
@@ -0,0 +1,43 @@
+.. _bodhi:
+
+Pagure Dist Git Interactions With Bodhi
+====
+
+`Bodhi <https://bodhi.fedoraproject.org>`_ is a service
+that handles package updates in Fedora Linux. It works as a gating system for
+Fedora updates and allows users to test the updates before being published in
+distribution.
+
+Possible Interactions
+----
+
+The following are a set of documented interactions possible between Pagure Dist
+Git and Bodhi.
+
+Configuration
+^^^^
+
+- The configuration in Bodhi uses ``pagure_url`` for dist git, default is
+  defined in
+  `config.py <https://github.com/fedora-infra/bodhi/blob/develop/bodhi-server/bodhi/server/config.py>`_
+
+API
+^^^^
+
+- Bodhi calls following API endpoints:
+
+  * ``/api/0/<namespace>/<package_name>`` to get information about contributors for the package
+  * ``/api/0/<namespace>/<package_name>/hascommit`` to check if user has commit access to package
+
+Changes proposed
+----
+
+In order to switch out Pagure Dist Git for an alternative that provides a
+relatively compatible API pattern, the following changes must be made in the
+places mentioned below.
+
+Necessary
+^^^^
+
+- If URL for dist git is change it will need to be reflected in
+  `deployment configuration <https://pagure.io/fedora-infra/ansible/blob/main/f/roles/bodhi2/base/templates/production.ini.j2>`_
diff --git a/docs/dist-git-move/index.rst b/docs/dist-git-move/index.rst
index 604c10d..8b242c3 100644
--- a/docs/dist-git-move/index.rst
+++ b/docs/dist-git-move/index.rst
@@ -43,6 +43,7 @@ Index
 .. toctree::
     :maxdepth: 1
 
+    bodhi
     ci
     copr
     fedpkg