From a9e553ed44f9a03be55d6a5a5f377f79bd09c0b1 Mon Sep 17 00:00:00 2001
From: Scott Anderson <scott@influxdata.com>
Date: Fri, 26 Jul 2019 15:52:58 -0600
Subject: [PATCH 1/2] added keepFirst param to difference function

---
 .../transformations/aggregates/difference.md  | 27 ++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
index f864f6626..d7d45b091 100644
--- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
+++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
@@ -17,7 +17,11 @@ _**Function type:** Aggregate_
 _**Output data type:** Float_
 
 ```js
-difference(nonNegative: false, column: "_value")
+difference(
+  nonNegative: false,
+  column: "_value",
+  keepFirst: false
+)
 ```
 
 ## Parameters
@@ -34,6 +38,13 @@ Defaults to `"_value"`.
 
 _**Data type:** String_
 
+### keepFirst
+Indicates if the first row should be kept.
+If `true`, the difference will be `null`.
+Defaults to `false`.
+
+_**Data type:** Boolean_
+
 ## Subtraction rules for numeric types
 - The difference between two non-null values is their algebraic difference;
   or `null`, if the result is negative and `nonNegative: true`;
@@ -90,6 +101,20 @@ from(bucket: "example-bucket")
 | 0004  | 6      | tv  |
 | 0005  | null   | tv  |
 
+
+#### With keepFirst set to true
+```js
+|> difference(nonNegative: false, keepfirst: true):
+```
+###### Output table
+| _time | _value | tag |
+|:-----:|:------:|:---:|
+| 0001  | null   | tv  |
+| 0002  | null   | tv  |
+| 0003  | -2     | tv  |
+| 0004  | 6      | tv  |
+| 0005  | null   | tv  |
+
 <hr style="margin-top:4rem"/>
 
 ##### Related InfluxQL functions and statements:

From b381781d19cba2024db4f0c8f7d80259668ccf0c Mon Sep 17 00:00:00 2001
From: Scott Anderson <scott@influxdata.com>
Date: Mon, 29 Jul 2019 10:49:49 -0600
Subject: [PATCH 2/2] updated difference function doc to address PR feedback

---
 .../functions/built-in/transformations/aggregates/difference.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
index d7d45b091..3e52efdba 100644
--- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
+++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/difference.md
@@ -39,7 +39,7 @@ Defaults to `"_value"`.
 _**Data type:** String_
 
 ### keepFirst
-Indicates if the first row should be kept.
+Indicates the first row should be kept.
 If `true`, the difference will be `null`.
 Defaults to `false`.