From b0013333de47eafd965579fa26e8f674b7e43ae1 Mon Sep 17 00:00:00 2001
From: superuser-does <32982579+superuser-does@users.noreply.github.com>
Date: Sun, 5 Apr 2026 10:15:15 +0100
Subject: [PATCH] [DOCS] Expand description list documentation (#9784)

* [DOCS] Expand description list documentation

* remove stray word
---
 .../Description Lists in WikiText.tid         | 36 +++++++++++++++++--
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/editions/tw5.com/tiddlers/wikitext/Description Lists in WikiText.tid b/editions/tw5.com/tiddlers/wikitext/Description Lists in WikiText.tid
index 687fb6772..6aa4be904 100644
--- a/editions/tw5.com/tiddlers/wikitext/Description Lists in WikiText.tid	
+++ b/editions/tw5.com/tiddlers/wikitext/Description Lists in WikiText.tid	
@@ -1,14 +1,44 @@
 caption: Description Lists
 created: 20131205160424246
-modified: 20251229110936191
+modified: 20260405082055301
 tags: WikiText
 title: Description Lists in WikiText
 type: text/vnd.tiddlywiki
 
-HTML description lists (<abbr title="also known as">AKA</abbr> definition lists) are created with this syntax:
+!! Basic syntax
+
+HTML description lists (<abbr title="also known as">AKA</abbr> definition lists) are created with this syntax: 
 
 <<wikitext-example src:"; Term being described
 : Description / Definition of that term
 ; Another term
 : Another description / definition
-">>
\ No newline at end of file
+">>
+
+!! Multiple terms and descriptions
+
+You can create multiple descriptions for a term, or multiple terms for a single description:
+
+<<wikitext-example src:"; Mouse
+: A rodent with a small body and a long tail
+: A pointing device used to interact with a computer
+; Apple
+; Pear
+: A type of fruit belonging to the Rosaceae family
+">>
+
+!! Nested description lists
+
+Description lists may also be nested to create lists within lists:
+
+<<wikitext-example src:"; Coffee
+: A beverage prepared from roasted coffee beans
+:; Black coffee
+:: Coffee served without any additives
+:; Milk coffee
+:: Coffee combined with steamed or frothed milk
+::; Latte
+::: A coffee made with espresso and steamed milk
+; Tea
+: A beverage typically made from tea leaves
+">>