another comment for clarity; descriptions of each page

content/docs/interface/example0/_index.md

@@ -7,6 +7,7 @@ title: "Simple working examples"
 
 # Simple working examples (with Data Pipeline API functionality)
 
+This page gives simple examples of the **user written** *config.yaml* file alongside the working config file generated by `FAIR run`. Note that **the Data Pipeline API will take the working config file as an input**.
 ## Empty code run
 
 ### User written *config.yaml*

content/docs/interface/example1/_index.md

@@ -7,6 +7,8 @@ title: "Full working example (with descriptions of Data Pipeline API functionali
 
 # Full working example (with Data Pipeline API functionality)
 
+This page gives a full working example of the **user written** *config.yaml* file alongside the working config file generated by `FAIR run`. Note that **the Data Pipeline API will take the working config file as an input**.
+
 The following example downloads some data from outside the pipeline, does some processing in R (for example), and records the original file and the resultant data product into the pipeline.
 
 In this simple example, the user should run the following from the terminal:
@@ -234,7 +236,8 @@ Alternatively, the submission script may be written in Python.
 from data_pipeline_api.standard_api import StandardAPI
 
 with StandardAPI.from_config("config.yaml") as api:
-  matrix = read(api.link_read("records/SARS-CoV-2/scotland/cases-and-management"))
+  data = read(api.link_read("records/SARS-CoV-2/scotland/cases-and-management"))
+  data
   api.write_array("records/SARS-CoV-2/scotland/cases-and-management/mortality", "mortality_data", matrix)
   api.issue_with_component("records/SARS-CoV-2/scotland/cases-and-management/mortality", "mortality_data", "this data is bad", "7")
   api.finalise()
@@ -255,7 +258,7 @@ input_path = link_read(handle)
 
 # Process raw data and write data product
 data = read_csv(input_path)
-array = some_processing(data)
+array = some_processing(data) # e.g. data wrangling, running a model, etc.
 index = write_estimate(array, 
                        handle, 
                        data_product = "records/SARS-CoV-2/scotland/cases-and-management/mortality", 

content/docs/interface/example2/_index.md

@@ -7,6 +7,10 @@ title: "Additional working examples"
 
 # Additional working examples
 
+This page gives addition examples of the **user written** *config.yaml* file alongside the working config file generated by `FAIR run`. Note that **the Data Pipeline API will take the working config file as an input**.
+
+These examples may include variables not mentioned on previous pages or cases that might rarely be encountered such as using aliases.
+
 ## Read data product, process, and write data product (with aliases)
 
 ### User written *config.yaml*