X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fconfiguration.rst;fp=docs%2Fconfiguration.rst;h=af98c6e22f0518248c9f5203f18052b6100a470f;hb=fc00439357256a05f1b56220c64eee0acb81315f;hp=0000000000000000000000000000000000000000;hpb=d22c3fe8f7bc3f3276dedd7448c4f82f50fe7584;p=releng%2Fglobal-jjb.git

diff --git a/docs/configuration.rst b/docs/configuration.rst
new file mode 100644
index 00000000..af98c6e2
--- /dev/null
+++ b/docs/configuration.rst
@@ -0,0 +1,48 @@
+.. _global-jjb-configuration:
+
+#############
+Configuration
+#############
+
+Jenkins Files
+=============
+
+global-jjb makes use of the Jenkins Config File Provider plugin to provide some
+default configurations for certain tools. This section details the files to
+define in Jenkins' **Manage Files** configuration.
+
+npmrc
+-----
+
+This file contains default npmrc configuration and lives in $HOME/.npmrc.
+Documentation for npmrc is available via the `npm project
+<https://docs.npmjs.com/files/npmrc>`_.
+
+:Required: This file MUST exist. An empty file is acceptable if a
+proxy is not available for the project.
+:type: Custom file
+
+Create a "Custom file" with contents:
+
+.. code::
+
+   registry = https://nexus.opendaylight.org/content/repositories/npmjs/
+
+pip.conf
+--------
+
+This file contains default configuration for the python-pip tool and lives
+in $HOME/.config/pip/pip.conf. Documentation for pip.conf is available via the
+`pip project <https://pip.readthedocs.io/en/stable/user_guide/#configuration>`_.
+
+:Required: This file MUST exist. An empty file is acceptable if a
+proxy is not available for the project.
+:type: Custom file
+
+Create a "Custom file" with contents:
+
+.. code::
+
+   [global]
+   timeout = 60
+   index-url = https://nexus3.opendaylight.org/repository/PyPi/simple