docs update

Signed-off-by: Derek Smart <derek.smart@delphix.com>

Author: Derek Smart

README.md

@@ -1,10 +1,11 @@
 # Delphix Automation Framework
 
-Always include a project title with the largest heading. A project logo may replace the project title, if one has been designed. Project badges are common for OSS projects. They show quick information like Build Status, Download Count, etc... If there are any relevant badges, include them below the project title in MD format. In the paragraph immediately following the project title and badges, include information about the project and/or an overview that explains **what** the project is.
+The Delphix Automation Framework (DAF) allows automating data management via APIs at scale. Easily automate Delphix Self Service actions in CI/CD Pipelines without being tied to any specific CI Software.
 
 #### Table of Contents
 1.  [Description](#description)
 2.  [Installation](#installation)
+    *   [The delphix.yaml file](#delphix-yaml)
 3.  [Usage](#usage)
 4.  [Links](#links)
 5.  [Contribute](#contribute)
@@ -17,14 +18,18 @@ Always include a project title with the largest heading. A project logo may repl
 
 ## <a id="description"></a>Description
 
+DAF combines environment variables commonly available during CI/CD and data management as code in the `delphix.yaml` file to automate API calls to the Delphix Dynamic Data Platform. This allows for chain-able API calls that can be triggered during different stages of the CI/CD pipeline. The data state for different non-production environments is now visible through code configuration and that configuration is under version control.
 
 ## <a id="installation"></a>Installation
 
+The tools and executable for DAF have been containerized with docker for convenience. Use the latest version by pulling the container below.
+
 ```bash
 docker pull delphix/daf
 ```
+### <a id="delphix-yaml"></a>The delphix.yaml file
 
-Create a `delphix.yaml` file based on this guide: [Configure Delphix YAML](./configure-delphix-yaml.md)
+The `delphix.yaml` file is the configuration file that defines the data management as code strategy for the project. Create a `delphix.yaml` file based on this guide: [Configure Delphix YAML](./configure-delphix-yaml.md)
 
 ## <a id="usage"></a>Usage
 

configure-delphix-yaml.md

@@ -45,6 +45,7 @@ environments:
 |[branch](#branch)|The source GIT branch for a specific Application Environment.
 |[datapod](#datapod)|The Delphix Datapod for a specific Application Environment.
 |[when](#when)|The collection of Actions for a specific Application Environment.
+|[then](#then)|The Delphix Self Service action executed for this `when` trigger.
 
 
 ### <a id="template"></a>template
@@ -92,6 +93,10 @@ The name of the datapod used for the database of the environment. Must have been
 
 The collection of Actions for an environment based on the Given -> When -> Then format described above.
 
+### <a id="then"></a>then
+
+The specific Self Service API call to be executed during this Action. Acceptable values: `datapod.refresh`, `datapod.create`, `datapod.delete`, `bookmark.share`, `bookmark.create`, `datapod.undo`, and `bookmark.delete`.
+
 ## Overwrites
 
 Each environment has the ability to overwrite individual values for connectors or data-sources. A specific environment might need to use a different AMI or have different database connector keys.