X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fconfiguration.rst;h=97e9d5b67b390bcca3d1923f2936c961f9aaacaa;hb=47714de72c423cbdc52908dad1c7ef29e2d0fd28;hp=221217d1ef287b6050a61fc367cec968e4327bc2;hpb=a8ff64a75b1ad6bd284be761bdf0c3152fb189c0;p=releng%2Fglobal-jjb.git

diff --git a/docs/configuration.rst b/docs/configuration.rst
index 221217d1..97e9d5b6 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -36,11 +36,14 @@ values used by global-jjb templates.
 :git-url: Set this to the base URL of your GitHub repo. In
     general this should be https://github.com. If you are using
     GitHub Enterprise, or some other GitHub-style system, then it
-    should be whatever your installation base URL is.
+    should be whatever your installation base URL is. This sets a job
+    property that GitHub Pull Request Builder requires to work.
+    Note that this is the web url to your project: (eg. https://github.com/$ORG/$PROJECT)
 
 :git-clone-url: This is the clone prefix used by GitHub jobs.
-    Set this to either the same thing as **git-url** or the
-    'git@github.com:' including the trailing ':'
+    Set this to either the same base url as **git-url**, or to
+    'git@github.com:' including the trailing ':'.  Determined
+    by your clone method (https or git).
 
 :github-org: The name of the GitHub organization interpolated
     into the scm config.