From b6c0bb6ec74e56e2c94562e01f586967cc2e2709 Mon Sep 17 00:00:00 2001
From: Frances Elliott <42477011+fscelliott@users.noreply.github.com>
Date: Wed, 3 Mar 2021 11:54:02 -0700
Subject: [PATCH 1/3] Update openapi.yaml

---
 api/openapi-spec/openapi.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/api/openapi-spec/openapi.yaml b/api/openapi-spec/openapi.yaml
index df30c103..269251da 100644
--- a/api/openapi-spec/openapi.yaml
+++ b/api/openapi-spec/openapi.yaml
@@ -30,7 +30,7 @@ paths:
           $ref: '#/components/responses/Forbidden'
   /v1/datafile:
     get:
-      summary: Return the datafile for the given environment
+      summary: Return the datafile for the given environment. This allows you more control over which datafiles and versions are served than fetching the datafile from the Optimizely CDN.
       operationId: getDatafile
       description: Returns the json datafile for the given environment.
       responses:

From a75ccb1029848d7524a16d0818a9a9fe6f24ca33 Mon Sep 17 00:00:00 2001
From: Frances Elliott <42477011+fscelliott@users.noreply.github.com>
Date: Wed, 3 Mar 2021 14:36:26 -0700
Subject: [PATCH 2/3] Update openapi.yaml

---
 api/openapi-spec/openapi.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/api/openapi-spec/openapi.yaml b/api/openapi-spec/openapi.yaml
index 269251da..78e88bee 100644
--- a/api/openapi-spec/openapi.yaml
+++ b/api/openapi-spec/openapi.yaml
@@ -30,7 +30,7 @@ paths:
           $ref: '#/components/responses/Forbidden'
   /v1/datafile:
     get:
-      summary: Return the datafile for the given environment. This allows you more control over which datafiles and versions are served than fetching the datafile from the Optimizely CDN.
+      summary: Return the datafile for the given environment. This endpoint gives you more control over datafiles and versions than fetching the datafile from the Optimizely CDN.
       operationId: getDatafile
       description: Returns the json datafile for the given environment.
       responses:

From 8057ceaccc20b9fdeac22608b327b9d229c09c44 Mon Sep 17 00:00:00 2001
From: Frances Elliott <42477011+fscelliott@users.noreply.github.com>
Date: Wed, 3 Mar 2021 14:58:59 -0700
Subject: [PATCH 3/3] Update openapi.yaml

---
 api/openapi-spec/openapi.yaml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/api/openapi-spec/openapi.yaml b/api/openapi-spec/openapi.yaml
index 78e88bee..f3a2d738 100644
--- a/api/openapi-spec/openapi.yaml
+++ b/api/openapi-spec/openapi.yaml
@@ -30,7 +30,9 @@ paths:
           $ref: '#/components/responses/Forbidden'
   /v1/datafile:
     get:
-      summary: Return the datafile for the given environment. This endpoint gives you more control over datafiles and versions than fetching the datafile from the Optimizely CDN.
+      summary: >-
+        Return the datafile for the given environment. If you need strict consistency, you can pass the datafile to other Optimizely instances. 
+        so that all initialize from exactly the same datafile version (rather than each fetching the datafile separately from the Optimizely CDN).  
       operationId: getDatafile
       description: Returns the json datafile for the given environment.
       responses: