Chore: Upgrade Jenkins-job-builder to 6.3.0
[releng/global-jjb.git] / docs / index.rst
index c1d16db..85400e8 100644 (file)
@@ -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. Developed for LFCI to deploy management Jenkins jobs to an LF
+managed Jenkins instance, there are other jobs defined which may be helpful
+to projects that use the same build technology. The intention is to help
+projects save time from having to define their own job templates.
+
+Release Notes
+-------------
+
+.. toctree::
+   :maxdepth: 2
+
+   release-notes
 
 Guides
 ------
@@ -14,20 +26,24 @@ Guides
 .. toctree::
    :maxdepth: 2
 
+   install
+   configuration
+
    best-practices
+   glossary
+   appendix
 
 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.
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
 
-- :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`
+   jjb/*
 
 Indices and tables
 ==================