Merge pull request #772 from zihanKuang/add-console

docs: Add Instructor Console Guide`

Author: zihanKuang

content/en/cloud/academy/creating-content/instructor-console-guide/images/academy-admin.svg

@@ -0,0 +1,205 @@
+---
+title: "Academy Instructor Console Guide"
+weight: 5
+description: >
+  A comprehensive guide to using the Instructor Console. Learn how to track learner progress, analyze test performance, and manage your academy's content and metrics.
+categories: [Academy]
+tags: [Academy]
+---
+
+The [Academy Instructor Console](https://cloud.layer5.io/academy/instructors-console) serves as your command center for the Layer5 Academy, providing both a comprehensive overview of your content and detailed insights into learner engagement.
+
+### Gaining Access
+
+To view the Instructor Console, you must have the **Academy Admin** role or be an **organization admin**.
+
+{{< alert type="info" title="Enterprise Feature" >}}
+The Instructor Console and custom academy features are available exclusively for organizations on an Enterprise plan. [Learn more](https://layer5.io/pricing)
+{{< /alert >}}
+
+![Academy Admin Role](./images/academy-admin.svg)
+
+### Using the Content Creation Tool
+
+The Instructor Console includes a Content Creation Tool to help you develop new learning materials. It's a simple, guided process that generates the initial configuration for your content.
+
+This tool walks you through three quick steps to create your content's boilerplate configuration.
+
+![Content Creation Tool](./images/create-content-model.gif)
+
+1. **Basic Information**: First, you'll provide the essential details for your new content, such as its **Content Type** (Learning Path/Certification/Challenge), **Title**, and **Description**.
+
+    | Feature | Learning Path | Challenge | Certification |
+    | :--- | :--- | :--- | :--- |
+    | Primary Goal | To teach and guide through a comprehensive curriculum. | To solve a specific, hands-on problem in a competitive scenario. | To validate and prove existing knowledge through formal examination. |
+    | Main Content | Lessons, informational pages, labs, and progressive assessments. | A set of instructions for a practical task and a validation mechanism. | A series of exams, potentially with a brief study guide. |
+    | Outcome | Acquired knowledge and skills. | A score and rank status. | An optional, paid official certificate and a verifiable badge.|
+
+2. **Content Details**: Next, you'll refine additional properties for the content.
+
+> Need help understanding these properties? [Learn more](/cloud/academy/creating-content/creating-your-learning-path/#2-structure-your-learning-path).
+
+3. **Copy Template**: Finally, the Creation Tool presents you with a **"Generated Front Matter & Setup Guide"**. You'll copy this YAML configuration and place it at the top of the corresponding `_index.md` file in your content repository.
+
+{{< alert type="info" title="Console Creation Tool vs. Full Guides" >}}
+Think of the console's creation tool as a 'quick start' generator. It generates the necessary configuration boilerplate, but the detailed work of writing, structuring files, and publishing your content is done in your Git repository. For that, you'll need to follow our [comprehensive guides](/cloud/academy/creating-content/).
+{{< /alert >}}
+
+## Understanding the Dashboard
+
+Below the creation tool is the main dashboard, which provides an overview of your academy's statistics through a series of widgets.
+
+### Core Metrics
+
+These charts display your most important, high-level statistics, giving you a snapshot of your academy's health:
+
+![Core Metrics Dashboard](./images/core-metrics.png)
+
+- **Total Learners**: Represents the overall reach of your academy. This is the total number of people who have ever shown interest in your content.
+- **Active Learners**: Measures current engagement. This is the number of learners currently working through content, giving you an idea of your active student body.
+- **Total Test Taken**: Indicates the level of interaction with your assessments.
+
+**Strategic Uses**
+- Monitor Total Learners growth - steady increases indicate growing academy reach
+- Analyze Total Test Taken - high counts suggest challenging material requiring retakes, low counts may indicate learners avoiding assessments, assessments not being mandatory, or content being too easy
+
+{{< alert type="info" title="What Defines an 'Active Learner'?" >}}
+The **Active Learners** metric is a key indicator for engagement and billing, calculated based on the current status of content registrations.
+
+Specifically, it counts the number of registrations that are currently in the `Registered` status. This represents learners who have enrolled in your content but have not yet `Completed` it. It gives you a clear picture of your "in-progress" student body.
+{{< /alert >}}
+
+### Content Details
+
+This widget provides a quick inventory of your academy's content:
+
+- **Content Version**: Shows the version of the academy content your learners are using. 
+- **Content Stats**: Shows a quick count of the different types of content you've published. Each category is interactive; clicking on one will take you to the Academy Catalog, pre-filtered to show all your content of that type.
+
+![Content Details](./images/content-details.png)
+
+**Strategic Uses**
+- Monitor content version updates - when version numbers don't change, check if your GitHub releases and Layer5 Cloud deployments are complete
+- Track content distribution - if one content type dominates, consider diversifying your academy offerings
+
+{{< alert type="info" title="Content Versioning and Release Process" >}}
+If you've recently published new content but don't see the version number updated here, it is likely due to the platform's two-stage release process. Your updates become fully live only after both your content repository's GitHub Release is created and the subsequent Layer5 Cloud release is deployed. 
+
+For a complete walkthrough of this workflow, see the [Publishing Your Content Guide](/cloud/academy/creating-content/creating-your-learning-path/#5-publishing-your-learning-path).
+{{< /alert >}}
+
+### Learner Registration
+
+This chart provides an immediate visual summary of your learner base. 
+
+![Learner Registration](./images/learner-registration.png)
+
+While the chart will only display statuses that currently have data, the system recognizes the following definitions, each represented by a specific color:
+  -   `Registered` (Blue): The learner has enrolled but has not yet completed the content.
+  -   `Completed` (Green): The learner has successfully finished all required parts of the content.
+  -   `Withdrawn` (Red): The learner has unenrolled from the content.
+
+**Strategic Uses**
+- Monitor the `registered` vs `completed` ratio - if `registered` grows much faster than `completed`, your content may be too difficult or lacks engagement
+- Watch for large `withdrawn` segments - high withdrawal rates may indicate content quality issues or poor learner experience
+- Track completion rates over time - improving rates suggest content optimization success, declining rates may signal new content challenges
+
+### Content Metrics
+
+It lists your content and ranks them by the total number of passes, giving you a clear view of what learners find most engaging. Each title is a direct link, allowing you to navigate straight to it.
+
+![Content Metrics](./images/content-metrics.png)
+
+**Strategic Uses**
+- Identify top-performing content - high registration numbers indicate strong learner interest, use this to understand what resonates
+- Monitor new content launch performance - if new Learning Paths get few registrations, check marketing or content positioning
+- Compare content performance - if similar topics have very different registration numbers, investigate what makes the difference
+
+### All Learners Report
+
+The All Learners section provides a detailed, interactive table that allows you to track individual progress, see who is taking which content, and get a granular view of your learner base.
+
+![All Learners Report](./images/learners.png)
+
+#### Understanding the Table
+
+Each row in the table represents a single user's registration for a specific content. Here's what each column means:
+
+-   **USER**: The learner's information. Clicking the avatar will take you to their public user profile.
+-   **CURRICULA**: The specific content the user is enrolled in. Clicking the title will navigate you directly to that content.
+-   **REGISTERED AT**: A timestamp indicating when the user enrolled. This is shown as a relative time (e.g., "6 hours ago") and will display the full date on hover.
+-   **STATUS**: The learner's current standing in the content. The definition for each status is provided in the Learner Registration section [above](#learner-registration).
+
+#### Filtering and Finding Learners
+
+To find specific groups of learners, use the filter control at the top-right of the table.
+
+-   **Filter by Content Type**: Want to see everyone enrolled only in Certifications? Select `Certification` from the 'Content Type' filter.
+-   **Filter by Status**: Need a list of everyone who has successfully finished content? Select `Completed` from the 'Status' filter.
+
+#### Customizing Your View
+
+You can customize which columns are visible to tailor the report to your specific needs. Click the **View Columns** button at the top-right of the table. A dropdown menu will appear, allowing you to check or uncheck columns to show or hide them.
+
+![Filtering](./images/filter.png)
+
+#### Navigating Through Pages
+
+If there are a large number of learner registrations, the report is split into multiple pages. Use the controls at the bottom of the table to navigate through the data:
+
+**Rows per page**: Choose how many records to display on each page (e.g., 10, 25, 50).
+
+**Strategic Uses**
+- Identify at-risk learners - filter for users in `Registered` status for over 30 days, they may need support or content may be too challenging
+- Gather feedback from recent completions - contact learners who moved to `Completed` status within the last week while content is fresh in their minds
+
+### Analyzing Test Performance
+
+The final section is dedicated to analyzing the performance of your assessments. 
+
+![Test Statistics Overview](./images/test-stats.png)
+
+#### Test Stats
+
+These statistics provide a high-level summary of all test activities in your academy.
+
+-   **Pass/Fail Summary Bar:** This bar chart gives you an at-a-glance comparison of the total number of passed attempts (green) versus failed attempts (red) across all tests.
+
+-   **Insight Cards:** These three cards automatically surface key trends and outliers from your data:
+    -   **Most Difficult Test:** The quiz with the lowest pass-to-fail ratio, helping you identify challenging content.
+    -   **Easiest Test:** The quiz with the highest pass-to-fail ratio.
+    -   **Most Attempted Test:** The quiz that learners have attempted the most times, regardless of the outcome.
+
+#### Test Metrics
+
+The **Test Metrics** list provides a detailed performance breakdown for each individual test. Each test title in this list is a clickable link that will take you directly to that assessment.
+
+The percentage (e.g., `33%`) shows the overall pass rate for that specific test.
+
+{{< alert type="info" title="Identifying Problem Areas" >}}
+Use this list to quickly identify which specific assessments are causing the most trouble for your learners. A low pass rate on a particular assessment might indicate that the source material needs clarification or that the questions themselves are unclear.
+{{< /alert >}}
+
+**Strategic Uses**
+- Investigate difficult tests - when a quiz appears in the **Most Difficult Test** card with low pass rates, review the content and questions for clarity
+- Monitor test attempt patterns - if **Most Attempted Test** has low pass rates, learners may be struggling with fundamental concepts
+- Use pass rate trends - improving pass rates suggest content optimization success, declining rates may indicate new content is too challenging
+
+## Frequently Asked Questions
+
+<details>
+<summary>I'm my organization's administrator. Can I assign Academy Admin roles?</summary>
+Yes, you can assign Academy Admin roles to users within your organization. As an administrator, you have the ability to manage user permissions and roles in [user page](https://cloud.layer5.io/identity/users).
+</details>
+
+<details>
+<summary>Can I export the All Learners Report to a CSV or Excel file?</summary>
+
+Currently, the Instructor Console does not have a built-in feature to export the report directly to a file format like CSV. If you need this functionality urgently, please contact us at https://layer5.io/company/contact
+</details>
+
+<details>
+<summary>Does "Total Test Taken" show the number of unique learners who took tests?</summary>
+
+No. The "Total Test Taken" metric is a raw count of all attempts, including retakes by the same user. It is a measure of overall testing activity, not the number of unique learners who have been tested.
+</details>