From 306254b40e83189ae65fdda6501b1523d8c19c03 Mon Sep 17 00:00:00 2001
From: relaxcn <irelaxcn@outlook.com>
Date: Sun, 11 Jan 2026 03:51:36 +0800
Subject: [PATCH] improve the doc of `doc_paragraphs_missing_punctuation`

---
 clippy_lints/src/doc/mod.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/clippy_lints/src/doc/mod.rs b/clippy_lints/src/doc/mod.rs
index 2b41275ee3a4..ecf7acbd7ce6 100644
--- a/clippy_lints/src/doc/mod.rs
+++ b/clippy_lints/src/doc/mod.rs
@@ -692,6 +692,12 @@ declare_clippy_lint! {
     /// ///
     /// /// It was chosen by a fair dice roll.
     /// ```
+    ///
+    /// ### Terminal punctuation marks
+    /// This lint treats these characters as end markers: '.', '?', '!', '…' and ':'.
+    ///
+    /// The colon is not exactly a terminal punctuation mark, but this is required for paragraphs that
+    /// introduce a table or a list for example.
     #[clippy::version = "1.93.0"]
     pub DOC_PARAGRAPHS_MISSING_PUNCTUATION,
     restriction,