From d82cbcab114bf3ab7acb306c561b7a0d6e8b832d Mon Sep 17 00:00:00 2001
From: Lee Calcote <leecalcote@gmail.com>
Date: Tue, 23 Jun 2026 13:55:37 -0500
Subject: [PATCH 1/2] docs: add org-id shortcode demo page

Demonstrates the org-id shortcode, which renders the organization UUID
from the current page's content path (segment index 1).

Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
---
 .../academy-theme/org-id.md                   | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 content/content-formatting-examples/academy-theme/org-id.md

diff --git a/content/content-formatting-examples/academy-theme/org-id.md b/content/content-formatting-examples/academy-theme/org-id.md
new file mode 100644
index 00000000..504e40fc
--- /dev/null
+++ b/content/content-formatting-examples/academy-theme/org-id.md
@@ -0,0 +1,21 @@
+---
+title: Org ID
+linkTitle: Org ID
+weight: 9
+description: Academy theme org-id shortcode for rendering the organization UUID.
+draft: true
+---
+
+The `org-id` shortcode renders the organization UUID extracted from the current page's content path.
+
+Academy content is organized as `content/<type>/<orgID>/...` where `<orgID>` is a UUID at path segment index 1. When the page is within such a structure, the shortcode outputs the UUID inline as a `<code>` element.
+
+```text
+{{</* org-id */>}}
+```
+
+**Example:**
+
+{{< org-id >}}
+
+> **Note:** This demo page is not under a UUID-named directory, so the shortcode renders the fallback text. When used within a `content/learning-paths/<uuid>/...` path, it will output the organization's UUID.

From 4767fbe62da6153064d996b006c899db885b49ea Mon Sep 17 00:00:00 2001
From: Lee Calcote <leecalcote@gmail.com>
Date: Tue, 23 Jun 2026 13:59:46 -0500
Subject: [PATCH 2/2] docs: clarify org-id path is relative to content
 directory

Per review feedback, omit the `content/` prefix from the path
description to match Hugo's .File.Path which is relative to the
content directory (making <orgID> at index 1, not index 2).

Signed-off-by: Lee Calcote <lee.calcote@layer5.io>
---
 content/content-formatting-examples/academy-theme/org-id.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/content-formatting-examples/academy-theme/org-id.md b/content/content-formatting-examples/academy-theme/org-id.md
index 504e40fc..6f3afecc 100644
--- a/content/content-formatting-examples/academy-theme/org-id.md
+++ b/content/content-formatting-examples/academy-theme/org-id.md
@@ -8,7 +8,7 @@ draft: true
 
 The `org-id` shortcode renders the organization UUID extracted from the current page's content path.
 
-Academy content is organized as `content/<type>/<orgID>/...` where `<orgID>` is a UUID at path segment index 1. When the page is within such a structure, the shortcode outputs the UUID inline as a `<code>` element.
+Academy content is organized as `<type>/<orgID>/...` (relative to the content directory) where `<orgID>` is a UUID at path segment index 1. When the page is within such a structure, the shortcode outputs the UUID inline as a `<code>` element.
 
 ```text
 {{</* org-id */>}}