add explanations for 403 Forbidden (#5558)

* add explanations for `403 Forbidden` * Phrasing improvement Co-authored-by: Kevin Martens <[email protected]> Co-authored-by: Mark Waite <[email protected]> Co-authored-by: Kevin Martens <[email protected]>
jenkins-infra · Oct 6, 2022 · 492ca5a · 492ca5a
1 parent 64f83ee
commit 492ca5a
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/content/doc/developer/publishing/releasing-cd.adoc b/content/doc/developer/publishing/releasing-cd.adoc
@@ -296,6 +296,16 @@ This normally means that the secrets configured in the repository have expired,
 
 Alternatively you can temporarily update the secrets yourself with your own personal credentials.
 
+=== The upload to the Maven repository fails with "403 Forbidden"
+
+The two most common explanations for this error are:
+
+* You don't have permission to upload to the specified path.
+  link:../requesting-hosting/#request-upload-permissions[Learn more about how to request upload permissions].
+  Check that the path you're allowed to upload to matches the actual upload attempt (i.e. no typos).
+* The specified release already exists and you try to overwrite it.
+  We do not allow replacing existing releases.
+
 === Further troubleshooting help
 
 If none of the provided solutions help, send an email to the link:/mailing-lists[Jenkins developers mailing list] and explain what you did, and how it failed.