X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Findex.rst;h=0eec76f58e150b683dd5c42ca97b82daea1b2f0f;hb=0b1d0ba4945b93dc5d86fffef20f4be44fc5a2f9;hp=c1d16db8dce02b713ec6dea501045deb9fc6db08;hpb=df523ff68c8dbf3ad8eb09ef9cc04825bba86a4f;p=releng%2Fglobal-jjb.git

diff --git a/docs/index.rst b/docs/index.rst
index c1d16db8..0eec76f5 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -6,7 +6,19 @@ Linux Foundation Releng Global JJB
 Linux Foundation Release Engineering Global Jenkins Job Builder (JJB)
 Documentation.
 
-A collection of documentation for Linux Foundation JJB Templates.
+Global-JJB is a library project containing reusable Jenkins Job Builder
+templates. Mainly used by LFCI to deploy management Jenkins jobs to an LF
+managed Jenkins instance, there are other jobs defined for which may be helpful
+to projects whom use the same build technology. The intention is to save time
+for projects from having to define their own job templates.
+
+Release Notes
+-------------
+
+Global JJB provides regular releases. The release notes for all releases are
+available in the relnotes directory in Git.
+
+https://github.com/lfit/releng-global-jjb/tree/master/relnotes
 
 Guides
 ------
@@ -15,19 +27,23 @@ Guides
    :maxdepth: 2
 
    best-practices
+   configuration
 
 Global JJB Templates
 --------------------
 
-Job templates are designed in the `jjb/` directory but documentation is located
-in the `docs/jjb/` directory of this project.
+Job template code is in the `jjb/` directory but documentation is in the
+`docs/jjb/` directory of this project.
 
-- :doc:`jjb/lf-ci-jobs`
-- :doc:`jjb/lf-macros`
-- :doc:`jjb/lf-maven-jobs`
-- :doc:`jjb/lf-node-jobs`
-- :doc:`jjb/lf-python-jobs`
-- :doc:`jjb/lf-rtd-jobs`
+.. toctree::
+   :maxdepth: 1
+
+   jjb/lf-ci-jobs
+   jjb/lf-macros
+   jjb/lf-maven-jobs
+   jjb/lf-node-jobs
+   jjb/lf-python-jobs
+   jjb/lf-rtd-jobs
 
 Indices and tables
 ==================