Update examples doc

Author: kyungeonchoi

docs/examples.rst

@@ -4,62 +4,68 @@ Here are some examples of how to use the ServiceX client to extract data from a
 examples shows the three ways to specify a request: as a YAML file, as a Python dictionary, and
 as a typed Python object.
 
-The ServiceX Deliver Function
------------------------------
-The `deliver` function is used to submit a request to ServiceX. It takes a request in one of the
-three formats and returns a list `TransformedResult` objects. Each `TransformedResult` object
-is represents the result of a single sample in the request. The `TransformedResult` object
-contains the name of the sample, the output format, and a list of URLs or local file paths
-where the results can be found.
 
-How to Use YAML Specification
------------------------------
-In order to consume the YAML specification and pass it to the ServiceX `deliver` function
-you can use the following code:
+Examples For Each Query Type
+------------------
+Examples for each query type (Uproot-Raw, Func_ADL Uproot, Python Function) 
+and three different representations (Python Dictionary, Python Typed Object, and YAML).
+Note that all examples extract the same branch of the same tree (`ROOT TTree`) from 
+the same :ref:`dataset <label_dataset>`.
 
-.. code:: python
 
-    from servicex import deliver
+Uproot-Raw Query Example
+~~~~~~~~~~~~~~~~~~~~
+This example uses the raw uproot query type to extract the `AnalysisElectronsAuxDyn.pt` branch 
+from the `CollectionTree` tree in ATLAS PHYSLITE OpenData Dataset.
 
-    print(
-        deliver("config_Uproot_FuncADL.yaml")
-    )
+.. tabs::
+    
+    .. tab:: *Python Dict*
 
-Raw Uproot Example
-------------------
-This example uses the raw uproot query type to extract the `AnalysisElectronsAuxDyn.pt` branch from the `CollectionTree` tree
-in ATLAS PHYSLITE OpenData Dataset.
+        .. literalinclude:: ../examples/UprootRaw_Dict.py
+            :language: python
+    
+    .. tab:: *Python Typed Object*
 
-.. tabs::
+        .. literalinclude:: ../examples/UprootRaw_Typed.py
+            :language: python
 
     .. tab:: *YAML*
 
         .. literalinclude:: ../examples/config_UprootRaw.yaml
             :language: yaml
 
+
+Func_ADL Uproot Query Example
+~~~~~~~~~~~~~~~~~~~~
+This example uses an Func_ADL to extract the `AnalysisElectronsAuxDyn.pt` branch 
+from the `CollectionTree` tree in ATLAS PHYSLITE OpenData Dataset. 
+
+.. tabs::
+
     .. tab:: *Python Dict*
 
-        .. literalinclude:: ../examples/UprootRaw_Dict.py
+        .. literalinclude:: ../examples/FuncADL_Uproot_Dict.py
             :language: python
-    
+
     .. tab:: *Python Typed Object*
 
-        .. literalinclude:: ../examples/UprootRaw_Typed.py
+        .. literalinclude:: ../examples/FuncADL_Uproot_Typed.py
             :language: python
 
+    .. tab:: *YAML*
 
-Python Function Example
------------------------
-This example uses an uproot python function to extract the `AnalysisElectronsAuxDyn.pt` branch from the `CollectionTree` tree
-in ATLAS PHYSLITE OpenData Dataset. Note that you can specify a python function
-even in a yaml file.
+        .. literalinclude:: ../examples/config_FuncADL_Uproot.yaml
+            :language: yaml
 
-.. tabs::
 
-    .. tab:: *YAML*
+Python Function Query Example
+~~~~~~~~~~~~~~~~~~~~
+This example uses an uproot python function to extract the `AnalysisElectronsAuxDyn.pt` branch 
+from the `CollectionTree` tree in ATLAS PHYSLITE OpenData Dataset. 
+Note that you can specify a python function even in a yaml file.
 
-        .. literalinclude:: ../examples/config_PythonFunction.yaml
-            :language: yaml
+.. tabs::
 
     .. tab:: *Python Dict*
 
@@ -71,25 +77,35 @@ even in a yaml file.
         .. literalinclude:: ../examples/PythonFunction_Typed.py
             :language: python
 
+    .. tab:: *YAML*
 
-Func_ADL Uproot Example
------------------------
-This example uses an Func_ADL to extract the `AnalysisElectronsAuxDyn.pt` branch from the `CollectionTree` tree
-in ATLAS PHYSLITE OpenData Dataset. 
+        .. literalinclude:: ../examples/config_PythonFunction.yaml
+            :language: yaml
 
-.. tabs::
 
-    .. tab:: *YAML*
+The ServiceX Deliver Function
+-----------------------------
+The `deliver` function is used to submit a request to ServiceX. It takes a request in one of the
+three formats and returns a python dictionary with the name of the sample as a key 
+and a list of URLs or local file paths as a value. 
 
-        .. literalinclude:: ../examples/config_FuncADL_Uproot.yaml
-            :language: yaml
 
-    .. tab:: *Python Dict*
+How to Use YAML Specification
+-----------------------------
+YAML specification can be consumed by passing it to the ServiceX `deliver` function.
+You can use the following code:
 
-        .. literalinclude:: ../examples/FuncADL_Uproot_Dict.py
-            :language: python
+.. code:: python
 
-    .. tab:: *Python Typed Object*
+    from servicex import deliver
 
-        .. literalinclude:: ../examples/FuncADL_Uproot_Typed.py
-            :language: python
+    print(
+        deliver("config_Uproot_FuncADL.yaml")
+    )
+
+.. _label_dataset:
+The Dataset in Examples
+-----------------------
+The dataset in the examples is publically accessible ATLAS Open Data
+(`ATLAS DAOD PHYSLITE format Run 2 2016 proton-proton collision data 
+<https://opendata.cern.ch/record/80001>`_).

examples/config_FuncADL_Uproot.yaml

@@ -1,3 +1,5 @@
+# File: config_FuncADL_Uproot.yaml
+
 Sample:
   - Name: Uproot_FuncADL_YAML
     Dataset: !FileList  

examples/config_PythonFunction.yaml

@@ -1,3 +1,5 @@
+# File: config_PythonFunction.yaml
+
 Sample:
   - Name: Uproot_PythonFunction_YAML
     Dataset: !FileList  

examples/config_UprootRaw.yaml

@@ -1,3 +1,5 @@
+# File: config_UprootRaw.yaml
+
 Sample:
   - Name: UprootRaw_YAML
     Dataset: !FileList