From ebfb18a230c82883e194247eeaa3b6ccb11e2fdc Mon Sep 17 00:00:00 2001
From: Eli Bishop <eli@launchdarkly.com>
Date: Fri, 20 Jul 2018 15:15:05 -0700
Subject: [PATCH] add javadoc note about reasons in events

---
 .../launchdarkly/client/LDClientInterface.java    | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/main/java/com/launchdarkly/client/LDClientInterface.java b/src/main/java/com/launchdarkly/client/LDClientInterface.java
index f1d984d86..c851d38ef 100644
--- a/src/main/java/com/launchdarkly/client/LDClientInterface.java
+++ b/src/main/java/com/launchdarkly/client/LDClientInterface.java
@@ -101,7 +101,8 @@ public interface LDClientInterface extends Closeable {
 
   /**
    * Calculates the value of a feature flag for a given user, and returns an object that describes the
-   * way the value was determined.
+   * way the value was determined. The {@code reason} property in the result will also be included in
+   * analytics events, if you are capturing detailed event data for this flag.
    * @param featureKey   the unique key for the feature flag
    * @param user         the end user requesting the flag
    * @param defaultValue the default value of the flag
@@ -112,7 +113,8 @@ public interface LDClientInterface extends Closeable {
   
   /**
    * Calculates the value of a feature flag for a given user, and returns an object that describes the
-   * way the value was determined.
+   * way the value was determined. The {@code reason} property in the result will also be included in
+   * analytics events, if you are capturing detailed event data for this flag.
    * @param featureKey   the unique key for the feature flag
    * @param user         the end user requesting the flag
    * @param defaultValue the default value of the flag
@@ -123,7 +125,8 @@ public interface LDClientInterface extends Closeable {
   
   /**
    * Calculates the value of a feature flag for a given user, and returns an object that describes the
-   * way the value was determined.
+   * way the value was determined. The {@code reason} property in the result will also be included in
+   * analytics events, if you are capturing detailed event data for this flag.
    * @param featureKey   the unique key for the feature flag
    * @param user         the end user requesting the flag
    * @param defaultValue the default value of the flag
@@ -134,7 +137,8 @@ public interface LDClientInterface extends Closeable {
 
   /**
    * Calculates the value of a feature flag for a given user, and returns an object that describes the
-   * way the value was determined.
+   * way the value was determined. The {@code reason} property in the result will also be included in
+   * analytics events, if you are capturing detailed event data for this flag.
    * @param featureKey   the unique key for the feature flag
    * @param user         the end user requesting the flag
    * @param defaultValue the default value of the flag
@@ -145,7 +149,8 @@ public interface LDClientInterface extends Closeable {
 
   /**
    * Calculates the value of a feature flag for a given user, and returns an object that describes the
-   * way the value was determined.
+   * way the value was determined. The {@code reason} property in the result will also be included in
+   * analytics events, if you are capturing detailed event data for this flag.
    * @param featureKey   the unique key for the feature flag
    * @param user         the end user requesting the flag
    * @param defaultValue the default value of the flag