Merge "Update sleep session java doc so it's consistent with Jetpack doc" into udc-mainline-prod
diff --git a/framework/java/android/health/connect/datatypes/RecordTypeIdentifier.java b/framework/java/android/health/connect/datatypes/RecordTypeIdentifier.java
index 63bb873..1da419b 100644
--- a/framework/java/android/health/connect/datatypes/RecordTypeIdentifier.java
+++ b/framework/java/android/health/connect/datatypes/RecordTypeIdentifier.java
@@ -337,11 +337,11 @@
     public static final int RECORD_TYPE_EXERCISE_SESSION = 37;
 
     /**
-     * Captures user sleep session. Each session requires start and end time and a list of {@link
-     * SleepSessionRecord.Stage}.
+     * Captures the user's sleep length and its stages. Each record represents a time interval for a
+     * full sleep session.
      *
-     * <p>Each {@link SleepSessionRecord.Stage} interval should be between the start time and the
-     * end time of the session. Stages within one session must not overlap.
+     * <p>All {@link SleepSessionRecord.Stage} time intervals should fall within the sleep session
+     * interval. Time intervals for stages don't need to be continuous but shouldn't overlap.
      *
      * @see SleepSessionRecord
      */
diff --git a/framework/java/android/health/connect/datatypes/SleepSessionRecord.java b/framework/java/android/health/connect/datatypes/SleepSessionRecord.java
index 578c08c..77a90be 100644
--- a/framework/java/android/health/connect/datatypes/SleepSessionRecord.java
+++ b/framework/java/android/health/connect/datatypes/SleepSessionRecord.java
@@ -38,11 +38,11 @@
 import java.util.stream.Collectors;
 
 /**
- * Captures user sleep session. Each session requires start and end time and a list of {@link
- * Stage}.
+ * Captures the user's sleep length and its stages. Each record represents a time interval for a
+ * full sleep session.
  *
- * <p>Each {@link Stage} interval should be between the start time and the end time of the session.
- * Stages within one session must not overlap.
+ * <p>All {@link Stage} time intervals should fall within the sleep session interval. Time intervals
+ * for stages don't need to be continuous but shouldn't overlap.
  */
 @Identifier(recordIdentifier = RecordTypeIdentifier.RECORD_TYPE_SLEEP_SESSION)
 public final class SleepSessionRecord extends IntervalRecord {