arc/docs/dist-git-move/packagers.rst
2023-12-05 13:34:22 +10:00

45 lines
1.4 KiB
ReStructuredText

.. _packagers:
Pagure Dist Git Interactions by Fedora Packagers
================================================
Fedora Packagers are the group of Fedora contributors that use pagure-dist git
to manage specfiles and patches on packages.
Fedora Packagers use pagure dist-git to store specfiles and patches for all the
packages in the Fedora distribution.
There are two main workflows that a packager may utilise with interacting with dist-git.
The first is the traditional way by committing changes directly to the dist-git repo.
The second is using the PR-based workflow that pagure provides.
The Source tarballs are not stored in dist-git, but handled seperately by the lookaside
cache system. When preparing sources, a packager will use the `fedpkg upload` or
`fedpkg new-sources` commands to upload a tarball to the lookaside cache and update
the sources file on their local checkout. This file is then updated using one of the two
workflows (git push or PR)
Git push Workflow
---------------------------
.. image:: ../_static/dist_git_system_packagerworkflow_push.png
:target: ../_images/dist_git_system_packagerworkflow_push.png
PR-based Workflow
-----------------
.. image:: ../_static/dist_git_system_packagerworkflow_pr.png
:target: ../_images/dist_git_system_packagerworkflow_pr.png
Changes proposed
----------------
Necessary
^^^^^^^^^
- None
Unnecessary
^^^^^^^^^^^
- None