From c547eac69e7455fdd15515ecf48a01de53e531fc Mon Sep 17 00:00:00 2001
From: Hyperling <me@hyperling.com>
Date: Fri, 21 Nov 2025 11:19:53 -0700
Subject: [PATCH] Add a README to the shortode folderwhich explains a few
 things..

---
 layouts/shortcodes/README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 layouts/shortcodes/README.md

diff --git a/layouts/shortcodes/README.md b/layouts/shortcodes/README.md
new file mode 100644
index 0000000..07cd229
--- /dev/null
+++ b/layouts/shortcodes/README.md
@@ -0,0 +1,17 @@
+Short codes provide code utility in content files. They can call partials but not other short codes.
+
+`comment.html` is intentionally blank, it allows comments in content files which do nothing.
+
+For block comments, use `hide.html` such as:
+
+```
+{{< hide >}}
+lalala
+
+this is markdown content
+
+# secret section not published yet
+
+super duper unfinished content
+{{< /hide >}}
+```