Describe (a,) vs (a) in docs

Fixes #24730

2 files changed, 16 insertions, 1 deletions

diff --git a/src/doc/reference.md b/src/doc/reference.md
index 19cbd6f90a5..f9ffcc9eb28 100644
--- a/src/doc/reference.md
+++ b/src/doc/reference.md
@@ -2431,11 +2431,18 @@ Tuples are written by enclosing zero or more comma-separated expressions in
 parentheses. They are used to create [tuple-typed](#tuple-types) values.
 
 ```{.tuple}
-(0,);
 (0.0, 4.5);
 ("a", 4usize, true);
 ```
 
+You can disambiguate a single-element tuple from a value in parentheses with a
+comma:
+
+```
+(0,); // single-element tuple
+(0); // zero in parentheses
+```
+
 ### Unit expressions
 
 The expression `()` denotes the _unit value_, the only value of the type with
diff --git a/src/doc/trpl/primitive-types.md b/src/doc/trpl/primitive-types.md
index aca6e327c3b..e017e222c74 100644
--- a/src/doc/trpl/primitive-types.md
+++ b/src/doc/trpl/primitive-types.md
@@ -248,6 +248,14 @@ or “breaks up” the tuple, and assigns the bits to three bindings.
 
 This pattern is very powerful, and we’ll see it repeated more later.
 
+You can disambiguate a single-element tuple from a value in parentheses with a
+comma:
+
+```
+(0,); // single-element tuple
+(0); // zero in parentheses
+```
+
 ## Tuple Indexing
 
 You can also access fields of a tuple with indexing syntax: