Adding docs for random order. Fixes #863 (#1016)

luckyframework · Jun 4, 2022 · 43d5791 · 43d5791
1 parent e9d9297
commit 43d5791
Showing 1 changed file with 13 additions and 0 deletions.
diff --git a/src/actions/guides/database/querying.cr b/src/actions/guides/database/querying.cr
@@ -429,6 +429,19 @@ class Guides::Database::Querying < GuideAction
     UserQuery.new.age.desc_order(:nulls_last)
     ```
 
+    ### Random Order
+
+    Return rows in a random order.
+
+    `SELECT COLUMNS FROM users ORDER BY RANDOM()`
+
+    ```crystal
+    UserQuery.new.random_order
+    ```
+
+    > Appending a specific order after a random order will use that specific order.
+    > (e.g. `UserQuery.new.random_order.username.desc_order` will order by username descending)
+
     ## Group By
 
     Return rows grouped by the `age` column.