update documentation

doc/source/getting-started.rst

@@ -5,9 +5,9 @@ You can get a development copy of the gstlal software suite from git.  Doing thi
   * https://git.ligo.org/lscsoft/gstlal
   * https://git.ligo.org/lscsoft/lalsuite
 
-Source tarballs are available here: http://software.ligo.org/lscsoft/source/
+Source tarballs for GstLAL packages and all the LIGO/Virgo software dependencies are available here: http://software.ligo.org/lscsoft/source/
 
-Limited inary packages are available here:
+Limited binary packages are available here: 
 
 Building and installing from source follows the normal GNU build procedures
 involving:

doc/source/gstlal-calibration/gstlal-calibration.rst

@@ -4,5 +4,4 @@ GstLAL calibration
 .. toctree::
    :maxdepth: 2
 
-   overview
    code

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

@@ -4,6 +4,5 @@ GstLAL inspiral
 .. toctree::
    :maxdepth: 2
 
-   overview
    tutorials/tutorials
    code

doc/source/gstlal-ugly/gstlal-ugly.rst

@@ -4,5 +4,4 @@ GstLAL ugly
 .. toctree::
    :maxdepth: 2
 
-   overview
    code

doc/source/gstlal/gstlal.rst

@@ -4,7 +4,6 @@ GstLAL
 .. toctree::
    :maxdepth: 2
 
-   overview
    tutorials/tutorials
    code
 

doc/source/overview.rst

 Overview
 ========
 
-FIXME
+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 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 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 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.
+
 

doc/source/publications.rst

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