From 067b78df0528262cb852592d0d6e0f49c0ae00ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Canouil?=
 <8896044+mcanouil@users.noreply.github.com>
Date: Sat, 1 Feb 2025 16:39:40 +0100
Subject: [PATCH] docs: add `random=true` to `lipsum` shortcode

Fixes quarto-dev/quarto-cli#11664
---
 docs/authoring/lipsum.qmd | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/authoring/lipsum.qmd b/docs/authoring/lipsum.qmd
index 5bb0ebc5f5..13968c520e 100644
--- a/docs/authoring/lipsum.qmd
+++ b/docs/authoring/lipsum.qmd
@@ -30,3 +30,9 @@ Here's an example of `lipsum` generating two paragraphs of text, by adding `{{{<
 
 - `{{{< lipsum nparas >}}}`: `nparas` describes the number of paragraphs of placeholder text to include in the document. 
 - `{{{< lipsum start-end >}}}`: `start` and `end` are two numbers that describe the range of lorem ipsum paragraphs to include in the document.
+
+`lipsum` generates the placeholder text in a deterministic way[^1], so the same parameters will always generate the same text, but using `random=true` will generate a paragraph or random set of paragraphs.
+
+- `{{{< lipsum 1 random=true >}}}`: This will generate a single paragraph of random lorem ipsum text.
+
+[^1]: Since 1.7.14. Earlier versions of Quarto generates random text.