From 07effe1bd595d5c77d5a754880660850132bfd6d Mon Sep 17 00:00:00 2001
From: Dennis van Raaij <13474308-dvraaij@users.noreply.gitlab.com>
Date: Nov 10 2024 21:35:28 +0000
Subject: [PATCH 1/2] Clarify the need for a Kerberos ticket for uploading source files


---

diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc
index dffb9c4..1c0adbb 100644
--- a/modules/ROOT/pages/Installing_Packager_Tools.adoc
+++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc
@@ -35,9 +35,14 @@ $ sudo usermod -a -G mock <your_local_username>
 ----
 
 [#kerberos_ticket]
-== Acquiring Kerberos ticket
+== Acquiring a Kerberos ticket
+
+A https://fedoraproject.org/wiki/Infrastructure/Kerberos[Kerberos] ticket is
+necessary for authenticating with xref:Using_the_Koji_Build_System.adoc[Koji]
+or DistGit when
+xref:Package_Maintenance_Guide.adoc#upload_new_source_files[uploading source files]
+to the lookaside cache.
 
-xref:Using_the_Koji_Build_System.adoc[Koji] uses https://fedoraproject.org/wiki/Infrastructure/Kerberos[Kerberos] for authentication.
 To acquire valid Kerberos ticket, do:
 
 ----
diff --git a/modules/ROOT/pages/Package_Maintenance_Guide.adoc b/modules/ROOT/pages/Package_Maintenance_Guide.adoc
index fd64ad9..2ea5239 100644
--- a/modules/ROOT/pages/Package_Maintenance_Guide.adoc
+++ b/modules/ROOT/pages/Package_Maintenance_Guide.adoc
@@ -132,6 +132,7 @@ This tells git to start considering these files as part of the repository locall
 When you `commit` and `push` later,
 this change is communicated to the server. 
 
+[#upload_new_source_files]
 === Upload new source files to the lookaside cache
 ....
 fedpkg new-sources
@@ -144,6 +145,9 @@ This will replace the current list of source files, not add to it.
 fedpkg upload
 ....
 
+NOTE: A valid xref:Installing_Packager_Tools.adoc#kerberos_ticket[Kerberos
+ticket] is required to upload source files.
+
 'Pristine' upstream sources (like release tarballs)
 and other larger source files
 are stored in the lookaside cache system,

From 6780466dfef35d5a350a05af65ad282023fe7d26 Mon Sep 17 00:00:00 2001
From: Dennis van Raaij <13474308-dvraaij@users.noreply.gitlab.com>
Date: Nov 10 2024 21:35:28 +0000
Subject: [PATCH 2/2] Fix admonition in 'Upload new source files to the lookaside cache'


---

diff --git a/modules/ROOT/pages/Package_Maintenance_Guide.adoc b/modules/ROOT/pages/Package_Maintenance_Guide.adoc
index 2ea5239..81b9c8d 100644
--- a/modules/ROOT/pages/Package_Maintenance_Guide.adoc
+++ b/modules/ROOT/pages/Package_Maintenance_Guide.adoc
@@ -138,8 +138,7 @@ this change is communicated to the server.
 fedpkg new-sources
 ....
 
-WARNING:
-This will replace the current list of source files, not add to it.
+WARNING: This will replace the current list of source files, not add to it.
 
 ....
 fedpkg upload