You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/cloud/academy/certification/index.md
+20-27Lines changed: 20 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,44 +4,39 @@ weight: 4
4
4
description: >
5
5
A step-by-step guide to building a professional certification in the Academy.
6
6
categories: [Academy]
7
-
tags: [Designer]
7
+
tags: [Academy]
8
8
---
9
9
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.
11
11
12
12
The successful completion of a Certification results in an official, shareable **Certificate of Completion** and a valuable badge, signifying a verified level of proficiency.
13
13
14
-
### Certification vs Other Content Types
14
+

15
+
16
+
## Certification vs Other Content Types
15
17
16
18
To better understand its unique role, here is a comparison with other content types in the Academy:
|**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.|
30
26
31
-
To create a new certification, you must first create a two-level directory structure:
27
+
## Directory Structure
32
28
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.
35
30
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>/`
37
32
38
33
### File Structure
39
34
40
35
Below is a typical file structure for a new certification:
41
36
42
37
```
43
38
content/certifications/
44
-
└── layer5-certification-exam/ <-- The <certification-name> directory
39
+
└── layer5-certification-exam/ <-- The <certification-name> directory
45
40
├── _index.md <-- Defines the certification's metadata
46
41
├── exam-1.md <-- (Optional) A standard content page for introduction
47
42
├── optional-exam-2.md <-- An optional supplementary exam
@@ -52,8 +47,6 @@ content/certifications/
52
47
-**`_index.md`**: The entry point for your certification containing all metadata (title, description, banner, etc.)
53
48
-**Exam Files (`*.md`)**: Individual Markdown files containing the exams. Order and optional status are controlled by frontmatter, not filename.
54
49
55
-
## Configuration
56
-
57
50
### Setting Up the Certification (`_index.md`)
58
51
59
52
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"
74
67
---
75
68
```
76
69
77
-
####Frontmatter Fields Reference
70
+
### Frontmatter Fields Reference
78
71
79
72
| Field | Required | Description |
80
73
| :--- | :--- | :--- |
81
74
|`type`| ✅ | Must be set to `"certification"` to identify this content correctly. |
82
75
|`id`| ✅ | A globally unique identifier (UUID) for the certification. |
83
76
|`title`| ✅ | The human-readable title that will be displayed to users. |
84
77
|`description`| ✅ | A comprehensive summary of the certification's scope and objectives. |
78
+
|`weight`| ❌ | Controls the display order (lower numbers appear first). |
85
79
|`banner`| ❌ | Path to an image in the `static` folder, e.g., `images/icon.svg`. |
86
-
|`weight`| ✅ | Controls the display order (lower numbers appear first). |
87
80
|`tags`| ❌ | Keywords for content discovery. Multiple tags can be selected. |
88
81
|`level`| ❌ | A string indicating the intended difficulty (e.g., `beginner`, `intermediate`, `advanced`). |
89
82
|`categories`| ❌ | A string that assigns the certification to a specific category. |
90
83
91
-
## Content Creation
92
-
93
-
### Composing Certification Content
84
+
## Composing Certification Content
94
85
95
86
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.
96
87
@@ -102,11 +93,13 @@ The content within a certification folder can include:
102
93
{{< alert type="info" title="How to Create and Configure Exams" >}}
103
94
Every "Exam" file within a certification follows the unified Academy assessment standard.
104
95
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.
106
97
{{< /alert >}}
107
98
108
99
## Advanced Features
109
100
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
+
110
103
### Certificate of Completion
111
104
112
105
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
115
108
116
109
### Monetization
117
110
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.
119
112
120
113
The specific steps for setting prices and integrating payment processing are planned for a future release and will be documented accordingly.
0 commit comments