From 3b67d969f4ecac97fbb86dedbe9e102bd87445ad Mon Sep 17 00:00:00 2001
From: kirti763 <kg4180553@gmail.com>
Date: Fri, 1 Aug 2025 07:15:53 +0530
Subject: [PATCH 1/3] docs: add academy debugging guide using layer 5 cloud
 events

Signed-off-by: kirti763 <kg4180553@gmail.com>
---
 .../creating-your-learning-path/index.md      | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/content/en/cloud/academy/creating-content/creating-your-learning-path/index.md b/content/en/cloud/academy/creating-content/creating-your-learning-path/index.md
index 580a0ee8f..6ebe43cc8 100644
--- a/content/en/cloud/academy/creating-content/creating-your-learning-path/index.md
+++ b/content/en/cloud/academy/creating-content/creating-your-learning-path/index.md
@@ -431,3 +431,37 @@ Use AWS S3 with signed URLs:
 <video src="{{</* s3_signed_url path="training/private.mp4" */>}}">
 ```
 </details>
+
+<details>
+  <summary>8. How do I debug using Layer5 Cloud Events?</summary>
+
+If your content is not appearing in the Academy after a GitHub release, it may have failed to publish. You can troubleshoot these issues using the **Events** section in [Layer5 Cloud](https://cloud.layer5.io).
+ 
+To view publishing logs:
+1. Navigate to **Settings > Events**
+2. Switch to the **Audit** tab
+3. Apply a filter using the action type:
+ `AcademyUpserted`
+This will show all attempts to upload content, including which ones failed and why.
+
+**Common Errors You Might See**
+- **Duplicate IDs**  
+  Two lessons or paths using the same identifier. You can fix this by renaming or regenerating unique IDs.
+
+- **Invalid Content Type**  
+  For example,
+  Instead of
+ ```yaml
+  type: "learning-paths"  
+  ``` 
+ it should be:
+ ```yaml
+ type: "learning-path"   
+ ```
+- **Missing Required Fields**
+ Ensure that title, description, and type are included in the content’s frontmatter.
+
+ {{< alert type="info" title="Tip" >}}
+ Use the event filter `AcademyRegisteredToContent` to track user activity, like who enrolled in which learning path.
+ {{< /alert >}}
+</details>
\ No newline at end of file

From f5d7384cdd0aeb4b9dcb7230d0248f1c03a64b25 Mon Sep 17 00:00:00 2001
From: kirti763 <kg4180553@gmail.com>
Date: Wed, 13 Aug 2025 16:07:18 +0530
Subject: [PATCH 2/3] update

Signed-off-by: kirti763 <kg4180553@gmail.com>
---
 .../creating-your-learning-path/index.md      | 356 ++++++++++++++++++
 1 file changed, 356 insertions(+)
 create mode 100644 content/en/cloud/academy/creating-your-learning-path/index.md

diff --git a/content/en/cloud/academy/creating-your-learning-path/index.md b/content/en/cloud/academy/creating-your-learning-path/index.md
new file mode 100644
index 000000000..43e7b6ef3
--- /dev/null
+++ b/content/en/cloud/academy/creating-your-learning-path/index.md
@@ -0,0 +1,356 @@
+---
+title: Creating Your First Learning Path
+weight: 3
+description: >
+  A hands-on tutorial that walks you through creating, structuring, and testing a custom learning path for the Layer5 Academy.
+categories: [Academy]
+tags: [Designer]
+---
+
+This guide provides a step-by-step walkthrough for creating and organizing a new learning path in the [Layer5 Academy](https://cloud.layer5.io/academy/overview). You'll learn how to set up your content repository, structure your courses, add assets, preview your work, and publish it for your organization.
+
+### Prerequisites
+
+Before you dive into creating your first learning path, it's helpful to be familiar with the core technologies and concepts used by the Academy platform. 
+
+- **Git and GitHub**: All learning content is managed in a Git repository.
+- **Markdown**: All course and chapter content is written in standard Markdown. 
+- **Hugo**: The entire Academy platform is built on the [Hugo](https://gohugo.io/) static site generator. 
+- **Academy Template & Theme**: We provide an `academy-example` repository that serves as a pre-configured template. [Layer5 Academy theme](https://github.com/layer5io/academy-theme) to ensure your content is styled correctly right out of the box.
+- **A Layer5 Cloud Account**: Required to obtain your Organization ID and Personal Access Token for publishing.
+
+## 1. Set Up Your Content Repository
+
+Start by preparing a dedicated Git repository for your learning content. Using our official Layer5 template to help you get started quickly.
+
+1. **Fork the academy-example Repository**
+
+- Go to the [academy-example repository](https://github.com/layer5io/academy-example) on GitHub.
+- Click **Fork** to create a copy under your own GitHub account.
+
+2. **Clone Your Fork Locally**
+
+- Use the `git clone` command to download your forked repository. 
+- Example:
+  ```bash
+  # Replace `<your-username>` with your actual GitHub username
+  git clone https://github.com/<your-username>/academy-example.git
+  cd academy-example
+  git checkout -b <your-feature-branch>
+  ```
+
+3. **Update the Go Module Path**
+
+    1. Open the `go.mod` file located at the root of your `academy-example` project.
+    2. The first line will be:
+      ```go
+      module github.com/layer5io/academy-example
+      ```
+    3. Change this line to match your fork's path:
+      ```go
+      module github.com/<your-username>/academy-example
+      ```
+    4. Save the file, then commit and push this change to your repository.
+
+{{< alert type="info" title="Critical Step" >}}
+This step is essential. It updates your repository's "identity card" (`go.mod`) to match its new "address" (your GitHub URL). Without this change, the Academy publishing process will fail.
+{{< /alert >}}
+
+## 2. Structure Your Learning Path
+
+The Academy uses a specific directory layout to keep each organization's content separate and secure.
+
+1. **Find Your Organization UUID**
+
+    Each learning path is tied to a specific organization and secured by a unique identifier (UUID). This is a system-generated ID that ensures your content is scoped only to your organization.
+
+{{< alert type="info" title="How to Find Your Organization UUID?" >}}
+You can find and copy your Organization UUID from your organization page on [Layer5 Cloud](https://cloud.layer5.io/identity/organizations).
+{{< /alert >}}
+
+2. **Create the Core Directories**
+
+    Now, inside your `academy-example` project, you should see the following top-level folders.
+
+    1. `content/learning-paths/<your-organization-uid>/`
+      This `content` directory is where all your written material lives. The folder hierarchy you create here directly defines the navigation and organization of your learning paths.
+    2. `static/<your-organization-uid>/`
+      This `static` directory is for all your assets, such as images, diagrams, and so on. 
+    3. `layouts/shortcodes/<your-organization-uid>/`
+      This `layouts` directory is for advanced use. You can place custom **Hugo Shortcodes** here if you need special reusable components in your Chapters.
+
+3. **Build the Content Hierarchy**
+
+    With the main folders in place, you can now structure your first course inside the `content` directory. The content is organized in a clear hierarchy: **Learning Path → Course → Chapter**.
+
+    A high-level view of the structure looks like this:
+
+    ```text
+    content/
+    └── learning-paths/
+        ├── _index.md
+        └── ea124d12-234a-6f78-9df0-1fa2b3e4d567/  // <-- Organization UID
+            └── mastering-kubernetes/              // <-- Learning Path
+                ├── _index.md
+                └── advanced-networking/           // <-- Course 1
+                └── core-concepts/                 // <-- Course 2
+                    ├── _index.md
+                    ├── 01-pods.md                 // <-- Chapter 1
+                    └── 02-services.md             // <-- Chapter 2
+    ```
+
+    Each folder represents a level in the hierarchy, and the `_index.md` file within a folder defines the metadata (like title and description) for that level. The final `.md` files are your individual Chapter.
+
+> For a deeper understanding of how Hugo uses `_index.md` to create content sections, you can refer to the official [Hugo Page Bundles documentation](https://gohugo.io/content-management/page-bundles/).
+
+4. **Front matter**
+
+    Use this at the top of each **Learning Path** page (`learning-paths/<orgId>/<slug>/_index.md` or similar):
+
+    ```yaml
+    ---
+    title: "Mastering Kubernetes for Engineers"
+    description: "Learn how to configure your Kubernetes clusters and manage the lifecycle of your workloads"
+    banner: null  # Optional, URL to banner image
+    ---
+    ```
+
+    > Place this frontmatter in the Markdown file that represents the learning path index page.
+
+    **Course Frontmatter (Optional Individual Course Pages)**
+
+      If each course has its own markdown page, you can use this frontmatter:
+
+    ```yaml
+    ---
+    title: "Kubernetes Basics"
+    description: "Learn the basics of Kubernetes"
+    weight: 1
+    banner: null  # Optional
+    ---
+    ```
+
+    **Summary of Required Fields**
+
+    | Type          | Field         | Required | Notes                       |
+    | ------------- | ------------- | -------- | --------------------------- |
+    | Learning Path | `title`       | ✅        |                             |
+    |               | `description` | ✅        |                             |
+    |               | `weight`      | ✅        | Order in path, lower first  |
+    |               | `banner`      | ❌        | Optional image URI          |
+    | Course        | `title`       | ✅        |                             |
+    |               | `description` | ✅        |                             |
+    |               | `weight`      | ✅        | Order in path   |
+    |               | `banner`      | ❌        | Optional image URI          |
+    |               | `prerequisites`      | ❌        | Optional List of prerequisites for the course |
+    |               | `draft`       | ❌        | Skips build, won't appear|
+    |               | `tags`        | ❌ | Keywords for content |
+    |               | `categories`  | ❌ |  Main content categories |
+
+
+{{< alert type="warning" title="Banner Image Paths" >}}
+When using the `banner` field in your frontmatter, always provide the full, static path to your image. This path must start with your Organization UUID; for example: `/org_id/images/kubernetes-icon.svg`.
+{{< /alert >}}
+
+> For a complete list of all predefined variables and advanced usage, please refer to the official [Hugo Front Matter documentation](https://gohugo.io/content-management/front-matter/).
+
+## 3. Add Assets and Interactive Content
+
+Enhance your course with images and other visual aids. The recommended and standard method for adding images is Page Bundling. This approach involves placing your image files directly alongside the Markdown content they belong to, which is simpler and keeps content organized.
+
+{{< alert type="success" title="Recommended Method: Page Bundling" >}}
+For all assets, please use the Page Bundling method. It simplifies asset management by co-locating images with the Markdown files that use them.
+{{< /alert >}}
+
+**How to Add an Image**
+
+1.  Place your image file (e.g., `hugo-logo.png`) in the **same directory** as your Markdown file (e.g., `Chapter-1.md`). 
+
+2.  In your `Chapter-1.md` file, embed the image using a **standard Markdown link**. The path should just be the filename.
+
+    ```markdown
+    ![The Hugo Logo](hugo-logo.png)
+    ```
+
+{{< alert type="warning" title="Legacy Method: Do Not Use" >}}
+The `usestatic` shortcode is **deprecated** and should not be used for new courses.
+{{< /alert >}}
+
+**How to Add a Video**
+
+```text
+{{</* card 
+title="Video: Example" */>}}
+<video width="100%" height="100%" controls>
+    <source src="https://exmaple.mp4" type="video/mp4">
+    Your browser does not support the video tag.
+</video>
+{{</* /card */>}}
+```
+
+## 4. Build and Preview Locally
+
+Before publishing, it is crucial to preview your content locally to check for formatting errors, broken links, and overall structure.
+
+```bash
+make site
+```
+
+This will start a local development server, where you can view your learning path as you build it.
+![Preview site](./images/preview-site.png)
+
+{{< alert type="info" title="Local Previews" >}}
+The local preview uses a generic theme to show the structure and content of your learning path. It **will not** display your organization's specific branding, such as custom logos or color schemes. The full, branded experience will only be visible after your content is published to the Layer5 Academy platform. 
+
+You can configure your organization's branding in the [Layer5 Cloud Organization Settings](https://cloud.layer5.io/identity/organizations).
+{{< /alert >}}
+
+## 5. Publishing Your Learning Path
+
+Once you have tested your content locally, you can publish it to the [Layer5 Academy](https://cloud.layer5.io/academy/overview) through our automated workflow. The process involves a one-time setup of secrets and then creating a GitHub Release to publish each new version.
+
+### Stage 1: Configure the Publishing Workflow (One-Time Setup)
+
+To allow your repository to securely communicate with the Academy's build system, you must configure GitHub Secrets. This one-time setup ensures your publishing workflow can authenticate automatically.
+
+#### 1. Verify Required Secret Names
+
+First, confirm the **exact secret names** required by the workflow.
+
+In your repository, open the workflow file at `.github/workflows/build-and-release.yml`. This confirms the workflow expects secrets named exactly `ACADEMY_ORG_ID` and `ACADEMY_TOKEN`.
+  ```yaml
+  with:
+    orgId: ${{ secrets.ACADEMY_ORG_ID }}
+    token: ${{ secrets.ACADEMY_TOKEN }}
+    # ... and other parameters
+  ```
+
+#### 2. Set Up Repository Secrets
+
+Now, create the two required secrets in your repository.
+
+1.  Navigate to your GitHub repository and go to `Settings` > `Secrets and variables` > `Actions`.
+2.  Ensure you are on the **Secrets** tab.
+3.  Click `New repository secret` to add the following two secrets:
+    1. **Name:** `ACADEMY_ORG_ID` 
+
+       **Value:** Paste your unique Organization ID string.
+
+    2. **Name:** `ACADEMY_TOKEN` 
+
+       **Value:** Paste the personal access token generated from Layer5 Cloud by following the instructions below.
+
+{{< alert type="info" title="How to Correctly Copy Your Token" >}}
+When you generate a token from the [Layer5 Cloud Tokens page](https://cloud.layer5.io/security/tokens), you will get a JSON object like this:
+`{"meshery-provider":"Meshery","token":"eyj...your-long-token-string..."}` You must copy only the token string itself—the value inside the quotes for the `"token"` key. 
+
+Do NOT include the curly braces `{}`, the `"token":` key, or the surrounding quotes. The value you paste into the secret should begin with `eyj...`.
+{{< /alert >}}
+
+Once configured correctly, your secrets page should look like this:
+![Secrets page showing correct configuration](./images/setting.png)
+
+{{< alert type="info" title="Alternative Method (Not Recommended)" >}}
+While you can hardcode your `ACADEMY_ORG_ID` directly in the workflow file, we strongly recommend using secrets for better security and flexibility.
+{{< /alert >}}
+
+### Stage 2: Publish by Creating a GitHub Release
+
+With the setup complete, you can publish your content anytime by creating a new release.
+
+1.  Ensure all your latest changes are committed and pushed to your repository's `master` branch.
+2.  On your GitHub repository page, navigate to the **"Releases"** section.
+3.  Click **"Draft a new release"**.
+4.  Create a new version tag for your release (e.g., `v1.0.1`).
+5.  Provide a title and description for your release.
+6.  Click **"Publish release"**.
+
+This action will automatically trigger the workflow, and your content will be deployed to the [Layer5 Academy](https://cloud.layer5.io/identity/overview).
+
+- Your content will be available in the [staging environment](https://staging-cloud.layer5.io/) within approximately 10 minutes.
+- Your content will go fully live to the production Academy platform during the next scheduled cloud release.
+
+> **For Urgent Updates:** If you have a time-sensitive publishing request or encounter any issues with the automated process, please [contact the Layer5 team](https://layer5.io/company/contact) for expedited assistance.
+
+![Release Example](./images/release-publish.gif)
+
+## Frequently Asked Questions
+
+<details>
+  <summary>1. Why is my workflow failing with a <code>401 Unauthorized</code> or <code>User must be logged in</code> error?</summary>
+  
+This error indicates an issue with your <code>ACADEMY_TOKEN</code>. Please ensure you have correctly copied only the token string and not the entire JSON object from the downloaded file.
+</details>
+
+<details>
+  <summary>2. Why is my workflow failing with a URL containing a double slash </code>( // )</code>?</summary>
+  
+A double slash in the URL (e.g., <code>.../api/academy//update/...</code>) means your <strong>ACADEMY_ORG_ID</strong> was not found. This typically happens when the secret name in your repository does not <strong>exactly match</strong> the name expected by the workflow file (e.g., <code>ORG_ID</code>).
+</details>
+
+<details>
+  <summary>3. How do I handle updates or corrections after my content is live?</summary>
+  
+All content updates are managed through your Git repository. Simply commit and push your changes, then <strong>create a new GitHub Release</strong> with a new version number (e.g., <code>v1.0.2</code>). This automatically triggers the publishing workflow and updates your content on the Academy platform.
+</details>
+
+<details>
+  <summary>4. What happens if my new content has an error?</summary>
+  
+The publishing process is designed to be safe. If your new content causes a build error, the workflow will fail, and the previously working version of the Academy will remain unchanged. Your broken update will not be published.
+</details>
+
+<details>
+  <summary>5. How do I structure multiple courses under one learning path?</summary>
+  
+The structure is defined by your folder hierarchy. A learning path is a directory, and each course is a sub-directory within that path. This folder structure in your <code>content</code> directory directly maps to the learning path structure presented to users.
+</details>
+
+<details>
+  <summary>6. Why does my local build fail when adding large videos?</summary>
+  
+The ideal size should be less than 10MB for our service performance and sustainability, and server resource management. If your asset size is larger than 10MB, we recommend using external hosting as listed.
+</details>
+ 
+<details>
+  <summary>7. How to securely host private training videos?</summary>
+  
+Use AWS S3 with signed URLs:
+```html
+<video src="{{</* s3_signed_url path="training/private.mp4" */>}}">
+```
+</details>
+
+<details>
+  <summary>8. How do I debug using Layer5 Cloud Events?</summary>
+
+If your content is not appearing in the Academy after a GitHub release, it may have failed to publish. You can troubleshoot these issues using the **Events** section in [Layer5 Cloud](https://cloud.layer5.io).
+ 
+To view publishing logs:
+1. Navigate to **Settings > Events**
+2. Switch to the **Audit** tab
+3. Apply a filter using the action type:
+ `AcademyUpserted`
+This will show all attempts to upload content, including which ones failed and why.
+
+**Common Errors You Might See**
+- **Duplicate IDs**  
+  Two lessons or paths using the same identifier. You can fix this by renaming or regenerating unique IDs.
+
+- **Invalid Content Type**  
+  For example,
+  Instead of
+ ```yaml
+  type: "learning-paths"  
+  ``` 
+ it should be:
+ ```yaml
+ type: "learning-path"   
+ ```
+- **Missing Required Fields**
+ Ensure that title, description, and type are included in the content’s frontmatter.
+
+ {{< alert type="info" title="Tip" >}}
+ Use the event filter `AcademyRegisteredToContent` to track user activity, like who enrolled in which learning path.
+ {{< /alert >}}
+</details>
\ No newline at end of file

From 38688d54cb10682bd43a518a35a5781a57615d38 Mon Sep 17 00:00:00 2001
From: Zihan Kuang <127078886+zihanKuang@users.noreply.github.com>
Date: Mon, 18 Aug 2025 21:00:35 +0800
Subject: [PATCH 3/3] Delete
 content/en/cloud/academy/creating-your-learning-path/index.md

Signed-off-by: Zihan Kuang <127078886+zihanKuang@users.noreply.github.com>
---
 .../creating-your-learning-path/index.md      | 356 ------------------
 1 file changed, 356 deletions(-)
 delete mode 100644 content/en/cloud/academy/creating-your-learning-path/index.md

diff --git a/content/en/cloud/academy/creating-your-learning-path/index.md b/content/en/cloud/academy/creating-your-learning-path/index.md
deleted file mode 100644
index 43e7b6ef3..000000000
--- a/content/en/cloud/academy/creating-your-learning-path/index.md
+++ /dev/null
@@ -1,356 +0,0 @@
----
-title: Creating Your First Learning Path
-weight: 3
-description: >
-  A hands-on tutorial that walks you through creating, structuring, and testing a custom learning path for the Layer5 Academy.
-categories: [Academy]
-tags: [Designer]
----
-
-This guide provides a step-by-step walkthrough for creating and organizing a new learning path in the [Layer5 Academy](https://cloud.layer5.io/academy/overview). You'll learn how to set up your content repository, structure your courses, add assets, preview your work, and publish it for your organization.
-
-### Prerequisites
-
-Before you dive into creating your first learning path, it's helpful to be familiar with the core technologies and concepts used by the Academy platform. 
-
-- **Git and GitHub**: All learning content is managed in a Git repository.
-- **Markdown**: All course and chapter content is written in standard Markdown. 
-- **Hugo**: The entire Academy platform is built on the [Hugo](https://gohugo.io/) static site generator. 
-- **Academy Template & Theme**: We provide an `academy-example` repository that serves as a pre-configured template. [Layer5 Academy theme](https://github.com/layer5io/academy-theme) to ensure your content is styled correctly right out of the box.
-- **A Layer5 Cloud Account**: Required to obtain your Organization ID and Personal Access Token for publishing.
-
-## 1. Set Up Your Content Repository
-
-Start by preparing a dedicated Git repository for your learning content. Using our official Layer5 template to help you get started quickly.
-
-1. **Fork the academy-example Repository**
-
-- Go to the [academy-example repository](https://github.com/layer5io/academy-example) on GitHub.
-- Click **Fork** to create a copy under your own GitHub account.
-
-2. **Clone Your Fork Locally**
-
-- Use the `git clone` command to download your forked repository. 
-- Example:
-  ```bash
-  # Replace `<your-username>` with your actual GitHub username
-  git clone https://github.com/<your-username>/academy-example.git
-  cd academy-example
-  git checkout -b <your-feature-branch>
-  ```
-
-3. **Update the Go Module Path**
-
-    1. Open the `go.mod` file located at the root of your `academy-example` project.
-    2. The first line will be:
-      ```go
-      module github.com/layer5io/academy-example
-      ```
-    3. Change this line to match your fork's path:
-      ```go
-      module github.com/<your-username>/academy-example
-      ```
-    4. Save the file, then commit and push this change to your repository.
-
-{{< alert type="info" title="Critical Step" >}}
-This step is essential. It updates your repository's "identity card" (`go.mod`) to match its new "address" (your GitHub URL). Without this change, the Academy publishing process will fail.
-{{< /alert >}}
-
-## 2. Structure Your Learning Path
-
-The Academy uses a specific directory layout to keep each organization's content separate and secure.
-
-1. **Find Your Organization UUID**
-
-    Each learning path is tied to a specific organization and secured by a unique identifier (UUID). This is a system-generated ID that ensures your content is scoped only to your organization.
-
-{{< alert type="info" title="How to Find Your Organization UUID?" >}}
-You can find and copy your Organization UUID from your organization page on [Layer5 Cloud](https://cloud.layer5.io/identity/organizations).
-{{< /alert >}}
-
-2. **Create the Core Directories**
-
-    Now, inside your `academy-example` project, you should see the following top-level folders.
-
-    1. `content/learning-paths/<your-organization-uid>/`
-      This `content` directory is where all your written material lives. The folder hierarchy you create here directly defines the navigation and organization of your learning paths.
-    2. `static/<your-organization-uid>/`
-      This `static` directory is for all your assets, such as images, diagrams, and so on. 
-    3. `layouts/shortcodes/<your-organization-uid>/`
-      This `layouts` directory is for advanced use. You can place custom **Hugo Shortcodes** here if you need special reusable components in your Chapters.
-
-3. **Build the Content Hierarchy**
-
-    With the main folders in place, you can now structure your first course inside the `content` directory. The content is organized in a clear hierarchy: **Learning Path → Course → Chapter**.
-
-    A high-level view of the structure looks like this:
-
-    ```text
-    content/
-    └── learning-paths/
-        ├── _index.md
-        └── ea124d12-234a-6f78-9df0-1fa2b3e4d567/  // <-- Organization UID
-            └── mastering-kubernetes/              // <-- Learning Path
-                ├── _index.md
-                └── advanced-networking/           // <-- Course 1
-                └── core-concepts/                 // <-- Course 2
-                    ├── _index.md
-                    ├── 01-pods.md                 // <-- Chapter 1
-                    └── 02-services.md             // <-- Chapter 2
-    ```
-
-    Each folder represents a level in the hierarchy, and the `_index.md` file within a folder defines the metadata (like title and description) for that level. The final `.md` files are your individual Chapter.
-
-> For a deeper understanding of how Hugo uses `_index.md` to create content sections, you can refer to the official [Hugo Page Bundles documentation](https://gohugo.io/content-management/page-bundles/).
-
-4. **Front matter**
-
-    Use this at the top of each **Learning Path** page (`learning-paths/<orgId>/<slug>/_index.md` or similar):
-
-    ```yaml
-    ---
-    title: "Mastering Kubernetes for Engineers"
-    description: "Learn how to configure your Kubernetes clusters and manage the lifecycle of your workloads"
-    banner: null  # Optional, URL to banner image
-    ---
-    ```
-
-    > Place this frontmatter in the Markdown file that represents the learning path index page.
-
-    **Course Frontmatter (Optional Individual Course Pages)**
-
-      If each course has its own markdown page, you can use this frontmatter:
-
-    ```yaml
-    ---
-    title: "Kubernetes Basics"
-    description: "Learn the basics of Kubernetes"
-    weight: 1
-    banner: null  # Optional
-    ---
-    ```
-
-    **Summary of Required Fields**
-
-    | Type          | Field         | Required | Notes                       |
-    | ------------- | ------------- | -------- | --------------------------- |
-    | Learning Path | `title`       | ✅        |                             |
-    |               | `description` | ✅        |                             |
-    |               | `weight`      | ✅        | Order in path, lower first  |
-    |               | `banner`      | ❌        | Optional image URI          |
-    | Course        | `title`       | ✅        |                             |
-    |               | `description` | ✅        |                             |
-    |               | `weight`      | ✅        | Order in path   |
-    |               | `banner`      | ❌        | Optional image URI          |
-    |               | `prerequisites`      | ❌        | Optional List of prerequisites for the course |
-    |               | `draft`       | ❌        | Skips build, won't appear|
-    |               | `tags`        | ❌ | Keywords for content |
-    |               | `categories`  | ❌ |  Main content categories |
-
-
-{{< alert type="warning" title="Banner Image Paths" >}}
-When using the `banner` field in your frontmatter, always provide the full, static path to your image. This path must start with your Organization UUID; for example: `/org_id/images/kubernetes-icon.svg`.
-{{< /alert >}}
-
-> For a complete list of all predefined variables and advanced usage, please refer to the official [Hugo Front Matter documentation](https://gohugo.io/content-management/front-matter/).
-
-## 3. Add Assets and Interactive Content
-
-Enhance your course with images and other visual aids. The recommended and standard method for adding images is Page Bundling. This approach involves placing your image files directly alongside the Markdown content they belong to, which is simpler and keeps content organized.
-
-{{< alert type="success" title="Recommended Method: Page Bundling" >}}
-For all assets, please use the Page Bundling method. It simplifies asset management by co-locating images with the Markdown files that use them.
-{{< /alert >}}
-
-**How to Add an Image**
-
-1.  Place your image file (e.g., `hugo-logo.png`) in the **same directory** as your Markdown file (e.g., `Chapter-1.md`). 
-
-2.  In your `Chapter-1.md` file, embed the image using a **standard Markdown link**. The path should just be the filename.
-
-    ```markdown
-    ![The Hugo Logo](hugo-logo.png)
-    ```
-
-{{< alert type="warning" title="Legacy Method: Do Not Use" >}}
-The `usestatic` shortcode is **deprecated** and should not be used for new courses.
-{{< /alert >}}
-
-**How to Add a Video**
-
-```text
-{{</* card 
-title="Video: Example" */>}}
-<video width="100%" height="100%" controls>
-    <source src="https://exmaple.mp4" type="video/mp4">
-    Your browser does not support the video tag.
-</video>
-{{</* /card */>}}
-```
-
-## 4. Build and Preview Locally
-
-Before publishing, it is crucial to preview your content locally to check for formatting errors, broken links, and overall structure.
-
-```bash
-make site
-```
-
-This will start a local development server, where you can view your learning path as you build it.
-![Preview site](./images/preview-site.png)
-
-{{< alert type="info" title="Local Previews" >}}
-The local preview uses a generic theme to show the structure and content of your learning path. It **will not** display your organization's specific branding, such as custom logos or color schemes. The full, branded experience will only be visible after your content is published to the Layer5 Academy platform. 
-
-You can configure your organization's branding in the [Layer5 Cloud Organization Settings](https://cloud.layer5.io/identity/organizations).
-{{< /alert >}}
-
-## 5. Publishing Your Learning Path
-
-Once you have tested your content locally, you can publish it to the [Layer5 Academy](https://cloud.layer5.io/academy/overview) through our automated workflow. The process involves a one-time setup of secrets and then creating a GitHub Release to publish each new version.
-
-### Stage 1: Configure the Publishing Workflow (One-Time Setup)
-
-To allow your repository to securely communicate with the Academy's build system, you must configure GitHub Secrets. This one-time setup ensures your publishing workflow can authenticate automatically.
-
-#### 1. Verify Required Secret Names
-
-First, confirm the **exact secret names** required by the workflow.
-
-In your repository, open the workflow file at `.github/workflows/build-and-release.yml`. This confirms the workflow expects secrets named exactly `ACADEMY_ORG_ID` and `ACADEMY_TOKEN`.
-  ```yaml
-  with:
-    orgId: ${{ secrets.ACADEMY_ORG_ID }}
-    token: ${{ secrets.ACADEMY_TOKEN }}
-    # ... and other parameters
-  ```
-
-#### 2. Set Up Repository Secrets
-
-Now, create the two required secrets in your repository.
-
-1.  Navigate to your GitHub repository and go to `Settings` > `Secrets and variables` > `Actions`.
-2.  Ensure you are on the **Secrets** tab.
-3.  Click `New repository secret` to add the following two secrets:
-    1. **Name:** `ACADEMY_ORG_ID` 
-
-       **Value:** Paste your unique Organization ID string.
-
-    2. **Name:** `ACADEMY_TOKEN` 
-
-       **Value:** Paste the personal access token generated from Layer5 Cloud by following the instructions below.
-
-{{< alert type="info" title="How to Correctly Copy Your Token" >}}
-When you generate a token from the [Layer5 Cloud Tokens page](https://cloud.layer5.io/security/tokens), you will get a JSON object like this:
-`{"meshery-provider":"Meshery","token":"eyj...your-long-token-string..."}` You must copy only the token string itself—the value inside the quotes for the `"token"` key. 
-
-Do NOT include the curly braces `{}`, the `"token":` key, or the surrounding quotes. The value you paste into the secret should begin with `eyj...`.
-{{< /alert >}}
-
-Once configured correctly, your secrets page should look like this:
-![Secrets page showing correct configuration](./images/setting.png)
-
-{{< alert type="info" title="Alternative Method (Not Recommended)" >}}
-While you can hardcode your `ACADEMY_ORG_ID` directly in the workflow file, we strongly recommend using secrets for better security and flexibility.
-{{< /alert >}}
-
-### Stage 2: Publish by Creating a GitHub Release
-
-With the setup complete, you can publish your content anytime by creating a new release.
-
-1.  Ensure all your latest changes are committed and pushed to your repository's `master` branch.
-2.  On your GitHub repository page, navigate to the **"Releases"** section.
-3.  Click **"Draft a new release"**.
-4.  Create a new version tag for your release (e.g., `v1.0.1`).
-5.  Provide a title and description for your release.
-6.  Click **"Publish release"**.
-
-This action will automatically trigger the workflow, and your content will be deployed to the [Layer5 Academy](https://cloud.layer5.io/identity/overview).
-
-- Your content will be available in the [staging environment](https://staging-cloud.layer5.io/) within approximately 10 minutes.
-- Your content will go fully live to the production Academy platform during the next scheduled cloud release.
-
-> **For Urgent Updates:** If you have a time-sensitive publishing request or encounter any issues with the automated process, please [contact the Layer5 team](https://layer5.io/company/contact) for expedited assistance.
-
-![Release Example](./images/release-publish.gif)
-
-## Frequently Asked Questions
-
-<details>
-  <summary>1. Why is my workflow failing with a <code>401 Unauthorized</code> or <code>User must be logged in</code> error?</summary>
-  
-This error indicates an issue with your <code>ACADEMY_TOKEN</code>. Please ensure you have correctly copied only the token string and not the entire JSON object from the downloaded file.
-</details>
-
-<details>
-  <summary>2. Why is my workflow failing with a URL containing a double slash </code>( // )</code>?</summary>
-  
-A double slash in the URL (e.g., <code>.../api/academy//update/...</code>) means your <strong>ACADEMY_ORG_ID</strong> was not found. This typically happens when the secret name in your repository does not <strong>exactly match</strong> the name expected by the workflow file (e.g., <code>ORG_ID</code>).
-</details>
-
-<details>
-  <summary>3. How do I handle updates or corrections after my content is live?</summary>
-  
-All content updates are managed through your Git repository. Simply commit and push your changes, then <strong>create a new GitHub Release</strong> with a new version number (e.g., <code>v1.0.2</code>). This automatically triggers the publishing workflow and updates your content on the Academy platform.
-</details>
-
-<details>
-  <summary>4. What happens if my new content has an error?</summary>
-  
-The publishing process is designed to be safe. If your new content causes a build error, the workflow will fail, and the previously working version of the Academy will remain unchanged. Your broken update will not be published.
-</details>
-
-<details>
-  <summary>5. How do I structure multiple courses under one learning path?</summary>
-  
-The structure is defined by your folder hierarchy. A learning path is a directory, and each course is a sub-directory within that path. This folder structure in your <code>content</code> directory directly maps to the learning path structure presented to users.
-</details>
-
-<details>
-  <summary>6. Why does my local build fail when adding large videos?</summary>
-  
-The ideal size should be less than 10MB for our service performance and sustainability, and server resource management. If your asset size is larger than 10MB, we recommend using external hosting as listed.
-</details>
- 
-<details>
-  <summary>7. How to securely host private training videos?</summary>
-  
-Use AWS S3 with signed URLs:
-```html
-<video src="{{</* s3_signed_url path="training/private.mp4" */>}}">
-```
-</details>
-
-<details>
-  <summary>8. How do I debug using Layer5 Cloud Events?</summary>
-
-If your content is not appearing in the Academy after a GitHub release, it may have failed to publish. You can troubleshoot these issues using the **Events** section in [Layer5 Cloud](https://cloud.layer5.io).
- 
-To view publishing logs:
-1. Navigate to **Settings > Events**
-2. Switch to the **Audit** tab
-3. Apply a filter using the action type:
- `AcademyUpserted`
-This will show all attempts to upload content, including which ones failed and why.
-
-**Common Errors You Might See**
-- **Duplicate IDs**  
-  Two lessons or paths using the same identifier. You can fix this by renaming or regenerating unique IDs.
-
-- **Invalid Content Type**  
-  For example,
-  Instead of
- ```yaml
-  type: "learning-paths"  
-  ``` 
- it should be:
- ```yaml
- type: "learning-path"   
- ```
-- **Missing Required Fields**
- Ensure that title, description, and type are included in the content’s frontmatter.
-
- {{< alert type="info" title="Tip" >}}
- Use the event filter `AcademyRegisteredToContent` to track user activity, like who enrolled in which learning path.
- {{< /alert >}}
-</details>
\ No newline at end of file