API-Reference.md

 > **Note: still not complete! needs checking from lizz**
 
-This page lists all available functions and variables used in the 
-ICOADS R HOSTACE toolbox.
+This page lists all available scripts, functions and variables from ICOADS used 
+in this repository. 
 
 **Workflow**
-____________
+------------
 
-Scripts here follow the same order as in the [Workflow](https://git.noc.ac.uk/brecinosrivas/icoads-r-hostace/-/wikis/workflow).
+Scripts here follow the same order as in the [Workflow diagram](https://git.noc.ac.uk/brecinosrivas/icoads-r-hostace/-/wikis/workflow).
 
 Script | Description 
 -------- |:------------
@@ -22,9 +22,9 @@ Script | Description
 [`clean2track.R`](https://git.noc.ac.uk/brecinosrivas/icoads-r-hostace/-/blob/master/rscripts/clean2track.R)   | Forms ship tracks for linked `id`'s. --.
 
 **Utils**
-____________
+---------
 
-Functions ordered alphabetically.
+The following functions are in alphabetical order.
 
 Function | Description 
 -------- |:------------
@@ -58,7 +58,7 @@ Function | Description
 
 Visit the [ICOADS main website](https://icoads.noaa.gov/) or check th [IMMA report](https://icoads.noaa.gov/e-doc/imma/R3.0-imma1.pdf).
 
-Variable names  ordered alphabetically.
+Variable names are in alphabetical order.
 ________________
 Code | Description 
 -----: |:------------