reorganize docs so information is easier to find

doc/source/gstlal/overview.rst

-Overview
-========
-
-FIXME

doc/source/gstlal/tutorials/tutorials.rst

-Tutorials
-=========
-
-.. toctree::
-   :maxdepth: 1
-
-   gstlal_fake_data_overview

doc/source/index.rst

@@ -10,26 +10,41 @@ Overview
 
 The GstLAL software package is used for the following activities:
 
-- **GstLAL:** The package `GstLAL <http://software.ligo.org/lscsoft/source/gstlal-1.4.1.tar.gz>`_ provides core Gstreamer plugins for signal processing workflows with LIGO data and core python bindings for constructing such workflows.  
+- ``gstlal`` provides core Gstreamer plugins for signal processing workflows with LIGO data and core python bindings for constructing such workflows.  
 
-- **GstLAL Calibration:** The package `GstLAL Calibration <http://software.ligo.org/lscsoft/source/gstlal-calibration-1.2.4.tar.gz>`_ provides real-time calibration of LIGO control system data into strain data.
+- ``gstlal-calibration`` provides real-time calibration of LIGO control system data into strain data.
 
-- **GstLAL Inspiral:** The package `GstLAL Inspiral <http://software.ligo.org/lscsoft/source/gstlal-inspiral-1.5.1.tar.gz>`_ provides additional signal processing plugins that are specific for LIGO / Virgo searches for compact binaries as well as a substantial amount of python code for post-processing raw signal processing results into gravitational wave candidate lists. Several publications about the methodology and workflow exist, see :ref:`publications`
+- ``gstlal-inspiral`` provides additional signal processing plugins that are specific for LIGO / Virgo searches for compact binaries as well as a substantial amount of python code for post-processing raw signal processing results into gravitational wave candidate lists. Several publications about the methodology and workflow exist, see :ref:`publications`
 
-- **GstLAL Ugly:** The package `GstLAL Inspiral <http://software.ligo.org/lscsoft/source/gstlal-inspiral-1.5.1.tar.gz>`_ is an incubator project for gradual inclusion in the other packages.
+- ``gstlal-burst`` provides additional signal processing plugins for use in astrophysical and noise transient burst searches.
 
+- ``gstlal-ugly`` is an incubator project for gradual inclusion in the other packages.
 
-.. _welcome-contents:
 
-Contents
--------------------------
+.. toctree::
+    :caption: Getting Started
+    :maxdepth: 2
+
+    installation
+    quickstart
+    tutorials/tutorials
+
+.. toctree::
+    :caption: User Guide
+    :maxdepth: 2
+
+    cbc_analysis
+    feature_extraction
+    fake_data
+    psd_estimation
+    publications
 
 .. toctree::
-   :maxdepth: 2
+    :caption: API Reference
+    :maxdepth: 2
 
-   getting-started
-   projects
-   publications
+    executables
+    api
 
 Build/Test Results
 -------------------------

doc/source/getting-started.rst → doc/source/installation.rst

-Getting started
+Installation
 ===============
 
 You can get a development copy of the gstlal software suite from git.  Doing this at minimum will require a development copy of lalsuite.

doc/source/projects.rst

-Projects
-========
-
-.. toctree::
-   :maxdepth: 1
-
-   gstlal/gstlal
-   gstlal-inspiral/gstlal-inspiral
-   gstlal-calibration/gstlal-calibration
-   gstlal-burst/gstlal-burst
-   gstlal-ugly/gstlal-ugly
-
-
-

doc/source/psd_estimation.rst

+.. _psd-generation:
+
+PSD Generation
+================
+
+WRITEME

doc/source/publications.rst

 .. _publications:
+
 Publications
 ============
 

doc/source/quickstart.rst

+.. _quickstart:
+
+Quickstart
+============
+
+WRITEME

doc/source/gstlal/tutorials/gstlal_fake_data_overview.rst → doc/source/tutorials/gstlal_fake_data_overview.rst

@@ -23,7 +23,7 @@ The basic steps to generate and validate LIGO colored noise are:
 
 An example PSD plot:
 
-.. image:: ../images/H1L1fakedataexamplepsd.png
+.. image:: ../gstlal/images/H1L1fakedataexamplepsd.png
    :width: 400px
 
 Custom colored noise, i.e. simulate your own detector
@@ -40,7 +40,7 @@ then you will need to first use gstlal_psd_xml_from_asd_txt to convert it
 in the documentation include this)
 1. Repeat the same validation steps as above to obtain, e.g.:
  
-.. image:: ../images/V1fakedataexamplepsd.png
+.. image:: ../gstlal/images/V1fakedataexamplepsd.png
    :width: 400px
 
 

doc/source/gstlal-inspiral/tutorials/offline_analysis.rst → doc/source/tutorials/offline_analysis.rst

-Documentation for running an offline compact binary coalescence analysis
+Running an offline compact binary coalescence analysis
 ========================================================================
 
 Prerequisites

doc/source/gstlal-burst/tutorials/running_offline_jobs.rst → doc/source/tutorials/offline_fx_jobs.rst

-####################################################################################################
-Running Offline Jobs
+Running offline feature extraction jobs
 ####################################################################################################
 
 An offline DAG is provided in /gstlal-burst/share/feature_extractor/Makefile.gstlal_feature_extractor_offline

doc/source/gstlal-inspiral/tutorials/online_analysis.rst → doc/source/tutorials/online_analysis.rst

-Documentation for starting an online compact binary coalescence analysis
+Running an online compact binary coalescence analysis
 ========================================================================
 
 Prerequisites

doc/source/gstlal-burst/tutorials/running_online_jobs.rst → doc/source/tutorials/online_fx_jobs.rst

-####################################################################################################
-Running Online Jobs
+Running online feature extraction jobs
 ####################################################################################################
 
 An online DAG is provided in /gstlal-burst/share/feature_extractor/Makefile.gstlal_feature_extractor_online

doc/source/gstlal-inspiral/tutorials/tutorials.rst → doc/source/tutorials/tutorials.rst

@@ -4,5 +4,8 @@ Tutorials
 .. toctree::
    :maxdepth: 1
 
+   gstlal_fake_data_overview
    online_analysis
    offline_analysis
+   online_fx_jobs
+   offline_fx_jobs

doc/sphinx-bindoc

@@ -23,7 +23,7 @@ outdir = sys.argv[1]
 
 tocf = open(os.path.join(outdir, "bin.rst"), "w")
 tocf.write("""bin
-===
+=====================
 
 .. toctree::
    :maxdepth: 1