From 81bf7331f37e1a34bee054da93a9c00d826bc910 Mon Sep 17 00:00:00 2001
From: Ankur Sinha (Ankur Sinha Gmail) <sanjay.ankur@gmail.com>
Date: Jun 20 2023 09:34:56 +0000
Subject: [PATCH 1/2] feat: add page on utilities


---

diff --git a/modules/ROOT/pages/Utilities.adoc b/modules/ROOT/pages/Utilities.adoc
new file mode 100644
index 0000000..98708fb
--- /dev/null
+++ b/modules/ROOT/pages/Utilities.adoc
@@ -0,0 +1,62 @@
+= Utilities for package maintainers
+
+A number of utilities are available to support package maintainers in maintaining their packages.
+This page attempts to list them, but is not a complete list.
+
+== Testing new builds with pull requests and CI
+
+To test updates and changes to packages,
+package maintainers are encouraged to use the continuous integration (CI) that is available on src.fedoraproject.org through pull requests.
+Each pull request will automatically run a test scratch build and report results in the pull request.
+
+One may need to re-run the test build in pull requests.
+A comment with `[citest]` will do so.
+
+More advanced CI using link:https://fedoraproject.org/wiki/Zuul-based-ci#How_to_attach_a_Pagure_repository_on_Zuul[Zuul] is also available.
+
+== Checking package update impact: fedrq
+
+Before updating their packages as per the xref:fesco::Updates_Policy.adoc[updates policy], package maintainers should check if/how the update impacts other packages.
+To list what packages depend on another in each Fedora release, package maintainers can use the link:https://fedrq.gtmx.me/[fedrq] tool.
+Example usage:
+
+[source, bash]
+----
+$ sudo dnf install fedrq
+
+$ fedrq whatrequires-src -b f38 python-pydantic
+fedrq-0.7.1-1.fc38.noarch
+fedrq-0.7.1-1.fc38.src
+input-remapper-2.0.0-2.fc38.noarch
+input-remapper-2.0.0-2.fc38.src
+matrix-synapse-1.85.2-1.fc38.src
+matrix-synapse-1.85.2-1.fc38.x86_64
+psi4-1:1.3.2-19.fc38.i686
+psi4-1:1.3.2-19.fc38.src
+psi4-1:1.3.2-19.fc38.x86_64
+python-aws-sam-translator-1.68.0-1.fc38.src
+python-bsmschema-0.1.0-1.fc38.src
+python-fastapi-0.96.0-1.fc38.src
+python-pytest-toolbox-0.4-12.fc37.src
+python-qcelemental-0.25.0-4.fc38.src
+python-qcengine-0.26.0-1.fc38.src
+python-versioningit-2.2.0-1.fc38.src
+python3-aws-sam-translator-1.68.0-1.fc38.noarch
+python3-bsmschema-0.1.0-1.fc38.noarch
+python3-fastapi-0.96.0-1.fc38.noarch
+python3-qcelemental-0.25.0-4.fc38.noarch
+python3-qcengine-0.26.0-1.fc38.noarch
+
+----
+
+== Running fedora-review on review tickets using fedora-review service
+
+The link:https://github.com/FrostyX/fedora-review-service/[Fedora Review Service] automatically runs `fedora-review` on new package review tickets.
+One can add a comment with `[fedora-review-service-build]` to re-run the review service.
+
+== Automating package updates: Packit
+
+link:https://packit.dev/[Packit] is a service that enables automated pull request creation for new upstream releases.
+More information on configuring dist-git repositories to use Packit can be found link:https://packit.dev/docs/fedora-releases-guide/#pull-from-upstream-job[in the documentation].
+
+Please remember to run impact checks before pushing updates.

From e2b673ac968c041b91b16b86a1c0b67503651eed Mon Sep 17 00:00:00 2001
From: Ankur Sinha (Ankur Sinha Gmail) <sanjay.ankur@gmail.com>
Date: Jun 20 2023 09:35:13 +0000
Subject: [PATCH 2/2] feat: add utils page to nav


---

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index 6a0f5a2..93bedb6 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -33,3 +33,5 @@
 * xref:Using_the_Koji_Build_System.adoc[Using the Koji Build System]
 
 * xref:Upstream_Release_Monitoring.adoc[Upstream Release Monitoring]
+
+* xref:Utilities.adoc[Package Maintenance Utilities]