From 0075085e9a7f659d44ddb99de6d1d64806ddf4b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Farkas?= <gabor.farkas@gmail.com>
Date: Fri, 20 May 2022 22:10:56 +0200
Subject: [PATCH] docs: describe ordering in http query results (#6024)

* docs: describe ordering in http query results

* improved text

Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>

* better text

Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>

* better text

Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>

Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>
---
 docs/sources/api/_index.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/sources/api/_index.md b/docs/sources/api/_index.md
index abd5ee03767f0..1515def55f3a4 100644
--- a/docs/sources/api/_index.md
+++ b/docs/sources/api/_index.md
@@ -155,6 +155,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples
@@ -277,12 +281,17 @@ Where `<matrix value>` is:
     <label key-value pairs>
   },
   "values": [
-    <number: second unix epoch>,
-    <string: value>
+    [
+      <number: second unix epoch>,
+      <string: value>
+    ],
+    ...
   ]
 }
 ```
 
+The items in the `values` array are sorted by timestamp, and the oldest item is first.
+
 And `<stream value>` is:
 
 ```
@@ -300,6 +309,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples