From 73a01565c5ba0774d65aa6f2384c44804fefa37d Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Wed, 22 Jan 2025 08:46:02 -0800
Subject: [PATCH] Remove comment shortcode documentation

---
 content/en/contribute/documentation.md | 10 ----------
 content/en/shortcodes/comment.md       |  1 +
 data/embedded_template_urls.toml       |  1 -
 3 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/content/en/contribute/documentation.md b/content/en/contribute/documentation.md
index 8f24d8235..8f2326fab 100644
--- a/content/en/contribute/documentation.md
+++ b/content/en/contribute/documentation.md
@@ -304,16 +304,6 @@ title: Example
 draft: false
 {{< /code-toggle >}}
 
-### comment
-
-Use the `comment` shortcode to include comments in your content. Hugo will ignore the text within these comments when rendering your site.
-
-```text
-{{%/* comment */%}}
-This will be hidden when rendering the page.
-{{%/* /comment */%}}
-```
-
 ### deprecated-in
 
 Use the `deprecated-in` shortcode to indicate that a feature is deprecated:
diff --git a/content/en/shortcodes/comment.md b/content/en/shortcodes/comment.md
index 1cf732516..208277bf5 100755
--- a/content/en/shortcodes/comment.md
+++ b/content/en/shortcodes/comment.md
@@ -9,6 +9,7 @@ menu:
     parent: shortcodes
     weight:
 weight:
+expiryDate: 2025-01-22 # with v0.142.0 and later use HTML comments instead
 ---
 
 {{% note %}}
diff --git a/data/embedded_template_urls.toml b/data/embedded_template_urls.toml
index 7ba055b28..f75b14f12 100644
--- a/data/embedded_template_urls.toml
+++ b/data/embedded_template_urls.toml
@@ -24,7 +24,6 @@
 'render-table' = '_default/_markup/render-table.html'
 
 # Shortcodes
-'comment' = 'shortcodes/comment.html'
 'details' = 'shortcodes/details.html'
 'figure' = 'shortcodes/figure.html'
 'gist' = 'shortcodes/gist.html'