diff --git a/docs/_static/dist_git_system_packagerworkflow_pr.png b/docs/_static/dist_git_system_packagerworkflow_pr.png new file mode 100644 index 0000000..c7b6ce1 Binary files /dev/null and b/docs/_static/dist_git_system_packagerworkflow_pr.png differ diff --git a/docs/_static/dist_git_system_packagerworkflow_pr.svg b/docs/_static/dist_git_system_packagerworkflow_pr.svg new file mode 100644 index 0000000..f3bff97 --- /dev/null +++ b/docs/_static/dist_git_system_packagerworkflow_pr.svg @@ -0,0 +1,801 @@ + + + +Packager's MachineLocal GIT.spec.patch.patch.patchsourcesDist Git.spec.patch.patch.patchsources.spec.patch.patch.patchsources.tar.gzLookaside Cache.tar.gzfedpkg uploadfedpkg new-sourceschanges sources filefedpkg pushgit pushForkMain.spec.patch.patch.patchsourcesPR &Merge diff --git a/docs/_static/dist_git_system_packagerworkflow_push.png b/docs/_static/dist_git_system_packagerworkflow_push.png new file mode 100644 index 0000000..1b6a163 Binary files /dev/null and b/docs/_static/dist_git_system_packagerworkflow_push.png differ diff --git a/docs/_static/dist_git_system_packagerworkflow_push.svg b/docs/_static/dist_git_system_packagerworkflow_push.svg new file mode 100644 index 0000000..487b76c --- /dev/null +++ b/docs/_static/dist_git_system_packagerworkflow_push.svg @@ -0,0 +1,612 @@ + + + +Packager's MachineLocal GIT.spec.patch.patch.patchsourcesDist Git.spec.patch.patch.patchsources.spec.patch.patch.patchsources.tar.gzLookaside Cache.tar.gzfedpkg uploadfedpkg new-sourceschanges sources filefedpkg pushgit push diff --git a/docs/dist-git-move/index.rst b/docs/dist-git-move/index.rst index 8bb0d95..5b63217 100644 --- a/docs/dist-git-move/index.rst +++ b/docs/dist-git-move/index.rst @@ -58,6 +58,7 @@ Interactions messaging monitorgating releng + packagers Index ------- diff --git a/docs/dist-git-move/packagers.rst b/docs/dist-git-move/packagers.rst new file mode 100644 index 0000000..0b71030 --- /dev/null +++ b/docs/dist-git-move/packagers.rst @@ -0,0 +1,45 @@ +.. _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