From 7084ac2e0bda2cc938d843d5de48b902f05a1210 Mon Sep 17 00:00:00 2001
From: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Date: Wed, 11 Aug 2021 16:09:56 +0200
Subject: [PATCH] Add additional info for time series

---
 source/core/timeseries-collections.txt | 29 ++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/source/core/timeseries-collections.txt b/source/core/timeseries-collections.txt
index 577350cc7c6..ab140056396 100644
--- a/source/core/timeseries-collections.txt
+++ b/source/core/timeseries-collections.txt
@@ -19,10 +19,31 @@ Time Series Collections
 .. versionadded:: 5.0
 
 :term:`Time series collections <time series collection>` efficiently
-store sequences of measurements over a period of time. Compared to
-normal collections, storing time series data in time series collections
-improves query efficiency and reduces the disk usage for time series
-data and :term:`secondary indexes <secondary index>`.
+store sequences of measurements over a period of time. Time series data
+is any data that is collected over time and is uniquely identified by
+one or more unchanging parameters. The unchanging parameters that
+identify your time series data is generally your data source's metadata.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30, 30, 40
+
+   * - **Example**
+     - **Measurement**
+     - **Metadata**
+   * - Weather data
+     - Temperature
+     - Sensor identifier, location
+   * - Stock data
+     - Stock price
+     - Stock ticker, exchange
+   * - Website visitors
+     - View count
+     - URL
+
+Compared to normal collections, storing time series data in time series
+collections improves query efficiency and reduces the disk usage for
+time series data and :term:`secondary indexes <secondary index>`.
 
 Procedures
 ----------