Merge pull request #1559 from mcanouil/docs/lipsum-random

docs: add `random=true` to `lipsum` shortcode

Author: cderv

docs/authoring/lipsum.qmd

@@ -30,3 +30,11 @@ 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` produces placeholder text in a predictable manner[^1]. This means that the same parameters will always yield identical text.
+However, you can choose to set `random=true` to generate a paragraph or a random collection of paragraphs.
+
+
+- `{{{< lipsum 1 random=true >}}}`: This will generate a single paragraph of random lorem ipsum text.
+
+[^1]: Since Quarto 1.7.14. Earlier versions of Quarto generate random text.