HTCondorWiki: Sub Dags Vs Splices

 Note:  In the process of creating this document (2016-06-14)
 
-This document is an explanation of why you might want to use the DAGMan external sub-DAG and splice features, and which one you might want to use in a particular situation.  (See
+This document is an explanation of why you might want to use the DAGMan _external sub-DAG_ and _splice_ features, and which one you might want to use in a particular situation.  (See
 {link: http://research.cs.wisc.edu/htcondor/manual/v8.5/2_10DAGMan_Applications.html#SECTION003108900000000000000}
 and
 {link: http://research.cs.wisc.edu/htcondor/manual/v8.5/2_10DAGMan_Applications.html#SECTION0031081000000000000000}
 for detailed information about external sub-DAGs and splices,
 respectively.)
 
+*When should I use one of these features?*
 
 Both external sub-DAGs and splices allow you to compose a large workflow from
 various sub-pieces that are defined in individual DAG files.  This is the
@@ -17,7 +18,13 @@
 that you want to combine in different ways to make different overall
 workflows.)
 
-*Feature Comparison*
+Some reasons to use external sub-DAGs or splices:
+*: Create a workflow from separate sub-workflows
+*: Dynamically create parts of the workflow (external sub-DAGs only)
+*: Re-try multiple nodes as a unit (external sub-DAGs only)
+*: Short-circuit parts of the workflow (external sub-DAGs only)
+
+*Feature comparison*
 
 Here's a table comparing external sub-DAGs and splices.  Note that the bold entries are the ones that are advantageous for a given feature.
 
@@ -41,9 +48,7 @@
 | Separate configuration for sub-workflows | yes | no | Can be good or bad |
 | One node status file, etc., for entire workflow | no | *yes* | |
 
-*When should I use one of these features?*
 
-(add stuff here)
 
 *Should I use external sub-DAGs or splices?*