Skip to content

Commit 36e20b9

Browse files
committed
update
Signed-off-by: ZihanKuang <[email protected]>
1 parent 6109ce0 commit 36e20b9

File tree

2 files changed

+20
-27
lines changed

2 files changed

+20
-27
lines changed
217 KB
Loading

content/en/cloud/academy/certification/index.md

Lines changed: 20 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,44 +4,39 @@ weight: 4
44
description: >
55
A step-by-step guide to building a professional certification in the Academy.
66
categories: [Academy]
7-
tags: [Designer]
7+
tags: [Academy]
88
---
99

10-
In [Layer5 Academy](https://cloud.layer5.io/academy/), a **Certification** is a top-level content type designed to formally **validate** a learner's professional skills and expertise in a specific domain. Unlike a Learning Path, which guides a user through a structured learning process, a Certification focuses primarily on **assessment and evaluation**.
10+
In [Layer5 Academy](https://cloud.layer5.io/academy/), a **Certification** is a top-level content type designed to formally **validate** a learner's professional skills and expertise in a specific domain. Unlike a Learning Path, which guides a user through a structured learning process, a Certification focuses primarily on assessment and evaluation.
1111

1212
The successful completion of a Certification results in an official, shareable **Certificate of Completion** and a valuable badge, signifying a verified level of proficiency.
1313

14-
### Certification vs Other Content Types
14+
![example image](./images/index-page.png)
15+
16+
## Certification vs Other Content Types
1517

1618
To better understand its unique role, here is a comparison with other content types in the Academy:
1719

1820
| Feature | Learning Path | Challenge | Certification |
1921
| :--- | :--- | :--- | :--- |
20-
| **Primary Goal** | To teach and guide through a comprehensive curriculum. | To solve a specific, hands-on problem in a competitive or timed scenario. | To **validate** and **prove** existing knowledge through formal examination. |
21-
| **Structure** | Hierarchical (Path → Courses → Modules). | Typically a single, scenario-based task. | Flat; a collection of one or more exams. |
22-
| **Main Content** | Lessons, informational pages, labs, and progressive assessments (Quizzes/Tests). | A set of instructions for a practical task and a validation mechanism. | A series of rigorous exams, potentially with a brief study guide. |
23-
| **Outcome** | Acquired knowledge and skills. | A score, rank, or completion status. | An **official certificate** and a badge signifying verified expertise. |
24-
25-
## Getting Started
26-
27-
### Directory Structure
28-
29-
All content for a new certification must reside within the main `content/certifications/orgID` directory. The structure is organized to group certifications by the organization that provides them, ensuring clarity and scalability.
22+
| Primary Goal | To teach and guide through a comprehensive curriculum. | To solve a specific, hands-on problem in a competitive or timed scenario. | To validate and prove existing knowledge through formal examination. |
23+
| Structure | Hierarchical (Path → Courses → Modules). | Typically a single, scenario-based task. | Flat; a collection of one or more exams. |
24+
| Main Content | Lessons, informational pages, labs, and progressive assessments (Quizzes/Tests). | A set of instructions for a practical task and a validation mechanism. | A series of rigorous exams, potentially with a brief study guide. |
25+
| Outcome | Acquired knowledge and skills. | A score, rank status. | An optional, paid official certificate and a verifiable badge.|
3026

31-
To create a new certification, you must first create a two-level directory structure:
27+
## Directory Structure
3228

33-
1. **Organization ID folder** (`orgID`) - Groups certifications by organization
34-
2. **Certification Name folder** (`<certification-name>`) - A descriptive, URL-friendly name (slug) for your certification
29+
All content for a new certification must reside within the `content/certifications/orgID` directory. To keep content organized, each certification has its own folder named with a descriptive, URL-friendly slug.
3530

36-
The URL will follow this pattern: `https://cloud.layer5.io/academy/certifications/orgID/certification-name/`
31+
The URL will follow this pattern: `https://cloud.layer5.io/academy/content/certifications/<certification-folder-name>/`
3732

3833
### File Structure
3934

4035
Below is a typical file structure for a new certification:
4136

4237
```
4338
content/certifications/
44-
└── layer5-certification-exam/ <-- The <certification-name> directory
39+
└── layer5-certification-exam/ <-- The <certification-name> directory
4540
├── _index.md <-- Defines the certification's metadata
4641
├── exam-1.md <-- (Optional) A standard content page for introduction
4742
├── optional-exam-2.md <-- An optional supplementary exam
@@ -52,8 +47,6 @@ content/certifications/
5247
- **`_index.md`**: The entry point for your certification containing all metadata (title, description, banner, etc.)
5348
- **Exam Files (`*.md`)**: Individual Markdown files containing the exams. Order and optional status are controlled by frontmatter, not filename.
5449

55-
## Configuration
56-
5750
### Setting Up the Certification (`_index.md`)
5851

5952
The `_index.md` file defines the core properties of your certification. Its frontmatter controls how the certification is presented to users and categorized within the Academy.
@@ -74,23 +67,21 @@ categories: "platform"
7467
---
7568
```
7669

77-
#### Frontmatter Fields Reference
70+
### Frontmatter Fields Reference
7871

7972
| Field | Required | Description |
8073
| :--- | :--- | :--- |
8174
| `type` || Must be set to `"certification"` to identify this content correctly. |
8275
| `id` || A globally unique identifier (UUID) for the certification. |
8376
| `title` || The human-readable title that will be displayed to users. |
8477
| `description` || A comprehensive summary of the certification's scope and objectives. |
78+
| `weight` || Controls the display order (lower numbers appear first). |
8579
| `banner` || Path to an image in the `static` folder, e.g., `images/icon.svg`. |
86-
| `weight` || Controls the display order (lower numbers appear first). |
8780
| `tags` || Keywords for content discovery. Multiple tags can be selected. |
8881
| `level` || A string indicating the intended difficulty (e.g., `beginner`, `intermediate`, `advanced`). |
8982
| `categories` || A string that assigns the certification to a specific category. |
9083

91-
## Content Creation
92-
93-
### Composing Certification Content
84+
## Composing Certification Content
9485

9586
A certification is primarily a collection of exams designed to validate a learner's skills. However, you can also include standard content pages to provide context and guide the learner.
9687

@@ -102,11 +93,13 @@ The content within a certification folder can include:
10293
{{< alert type="info" title="How to Create and Configure Exams" >}}
10394
Every "Exam" file within a certification follows the unified Academy assessment standard.
10495

105-
For detailed instructions on how to write an exam file, define various question types (single-answer, multiple-answer, short-answer), set scoring and passing percentages, and use advanced options, please refer to our comprehensive [Integrating Assessments in the Academy](../) guide.
96+
For detailed instructions on how to write an exam file, define various question types, set scoring and passing percentages, and use advanced options, please refer to our comprehensive [Integrating Assessments in the Academy](../) guide.
10697
{{< /alert >}}
10798

10899
## Advanced Features
109100

101+
Certifications include unique features that distinguish them from other content types in the Academy, providing additional value for both content creators and learners.
102+
110103
### Certificate of Completion
111104

112105
The primary outcome of successfully completing a certification is the issuance of an official Certificate of Completion. This certificate serves as a formal validation of the learner's skills and expertise in the subject matter.
@@ -115,6 +108,6 @@ The specific design, template, and data schema for the certificates are currentl
115108

116109
### Monetization
117110

118-
Certifications are designed with the capability to be configured as paid content. This allows organizations to offer premium, high-value accreditations for professional development.
111+
A key feature unique to the Certification content type is the ability to be configured as **paid content**. While accessing and participating in Learning Paths and Challenges are typically free, Certifications can be offered as premium, high-value accreditations for professional development.
119112

120113
The specific steps for setting prices and integrating payment processing are planned for a future release and will be documented accordingly.

0 commit comments

Comments
 (0)