From c91cd1fdfa7cb9357302f35ea24dd63729555d32 Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Mon, 13 Oct 2025 20:44:34 +0300 Subject: [PATCH 1/6] Add section on retaking assessments with retry options Signed-off-by: Nouran Atef --- content/en/cloud/academy/using-the-academy/index.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/content/en/cloud/academy/using-the-academy/index.md b/content/en/cloud/academy/using-the-academy/index.md index e27e3db24..5b070726b 100644 --- a/content/en/cloud/academy/using-the-academy/index.md +++ b/content/en/cloud/academy/using-the-academy/index.md @@ -115,6 +115,19 @@ If you're ever unsure about a concept, you can always use the Back button to rev ![Quiz Result - Passed](./images/q-result-pass.png) +### Retaking an Assessment + +If you don't pass an assessment on your first try, don't worry! You can retake it. The experience you have when retrying an exam depends on how the instructor has configured it. + +**Standard Retakes** : +For many exams, when you retry, you will be presented with the **exact same set of questions** you saw on your previous attempt. Often, instructors allow for unlimited retries, giving you multiple chances to review the material and pass the test. + +**Exams with a Question Bank** : +To ensure a fair and comprehensive assessment, some exams use a Question Bank. This means the instructor has created a large pool of questions, and you only see a small portion of them on any single attempt. + +If you retry an exam that uses a Question Bank, you will be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. + + ## Your Achievements Completing content in the Academy earns you valuable credentials that you can share with your professional network. From b119d1183dc0413e6989fa6579bfd352d689ebb8 Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Mon, 13 Oct 2025 20:54:13 +0300 Subject: [PATCH 2/6] docs: clarify learner perspective section Signed-off-by: Nouran Atef --- content/en/cloud/academy/using-the-academy/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/cloud/academy/using-the-academy/index.md b/content/en/cloud/academy/using-the-academy/index.md index 5b070726b..5f12673f0 100644 --- a/content/en/cloud/academy/using-the-academy/index.md +++ b/content/en/cloud/academy/using-the-academy/index.md @@ -125,7 +125,7 @@ For many exams, when you retry, you will be presented with the **exact same set **Exams with a Question Bank** : To ensure a fair and comprehensive assessment, some exams use a Question Bank. This means the instructor has created a large pool of questions, and you only see a small portion of them on any single attempt. -If you retry an exam that uses a Question Bank, you will be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. +If you retry an exam that uses a Question Bank, you may be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. ## Your Achievements From dad83220c0dc9bcad1ee6c1b7c1eeb4a75b6459a Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Tue, 14 Oct 2025 12:26:19 +0300 Subject: [PATCH 3/6] docs: update Signed-off-by: Nouran Atef --- content/en/cloud/academy/using-the-academy/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/cloud/academy/using-the-academy/index.md b/content/en/cloud/academy/using-the-academy/index.md index 5f12673f0..844661dc7 100644 --- a/content/en/cloud/academy/using-the-academy/index.md +++ b/content/en/cloud/academy/using-the-academy/index.md @@ -122,10 +122,10 @@ If you don't pass an assessment on your first try, don't worry! You can retake i **Standard Retakes** : For many exams, when you retry, you will be presented with the **exact same set of questions** you saw on your previous attempt. Often, instructors allow for unlimited retries, giving you multiple chances to review the material and pass the test. -**Exams with a Question Bank** : -To ensure a fair and comprehensive assessment, some exams use a Question Bank. This means the instructor has created a large pool of questions, and you only see a small portion of them on any single attempt. +**Exams with a Test Bank** : +To ensure a fair and comprehensive assessment, some exams use a Test Bank. This means the instructor has created a large pool of questions, and you only see a small portion of them on any single attempt. -If you retry an exam that uses a Question Bank, you may be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. +If you retry an exam that uses a Test Bank, you may be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. ## Your Achievements From 3e7227b3329051b8bc79c6c14b8b3e118f28d3e1 Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Mon, 20 Oct 2025 13:48:42 +0300 Subject: [PATCH 4/6] docs: updating retaking assessments section Signed-off-by: Nouran Atef --- content/en/cloud/academy/using-the-academy/index.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/content/en/cloud/academy/using-the-academy/index.md b/content/en/cloud/academy/using-the-academy/index.md index 844661dc7..2920e020a 100644 --- a/content/en/cloud/academy/using-the-academy/index.md +++ b/content/en/cloud/academy/using-the-academy/index.md @@ -117,15 +117,7 @@ If you're ever unsure about a concept, you can always use the Back button to rev ### Retaking an Assessment -If you don't pass an assessment on your first try, don't worry! You can retake it. The experience you have when retrying an exam depends on how the instructor has configured it. - -**Standard Retakes** : -For many exams, when you retry, you will be presented with the **exact same set of questions** you saw on your previous attempt. Often, instructors allow for unlimited retries, giving you multiple chances to review the material and pass the test. - -**Exams with a Test Bank** : -To ensure a fair and comprehensive assessment, some exams use a Test Bank. This means the instructor has created a large pool of questions, and you only see a small portion of them on any single attempt. - -If you retry an exam that uses a Test Bank, you may be presented with a **completely new set of questions**. This helps ensure you've mastered the subject matter, not just the answers to a specific set of questions. These exams might have a specific limit on the number of retries. +If you don’t pass an assessment on your first try, don’t worry you may be able to retake it. Depending on the certification, you may have unlimited retries, a limited number of retries, or in some cases, no retries at all. ## Your Achievements From 7d513d23163413e2f1fa6a6436df539448c0c8ed Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Mon, 20 Oct 2025 17:46:10 +0300 Subject: [PATCH 5/6] docs: add support for true-false question type Signed-off-by: Nouran Atef --- .../index.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md b/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md index 25e7c3f0f..82d4bd40b 100644 --- a/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md +++ b/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md @@ -144,7 +144,7 @@ questions: | | `questions` | ✅ | An array containing one or more question objects. | | **Question Object** | `id` | ✅ | Unique identifier for the question within the assessment (e.g., `q1`, `q2`). | | | `text` | ✅ | The text of the question prompt. | -| | `type` | ✅ | The type of question. Accepted values are `single-answer`, `multiple-answers` or `short-answer`. | +| | `type` | ✅ | The type of question. Accepted values are `single-answer`, `multiple-answers`, `short-answer`, or `true-false`. | | | `marks` | ✅ | The number of points awarded for a correct answer. | | | `instructions` | - | Custom instruction for each question | | | `options` | - | An array of answer options. | @@ -155,7 +155,7 @@ Remember: `type: "test"` are fixed values that cannot be modified. The system ne ## Supported Assessment Types -Layer5 Academy supports three question formats: +Layer5 Academy supports four question formats: ***Single Choice Questions*** - Single correct answer @@ -177,11 +177,18 @@ Layer5 Academy supports three question formats: is_correct: true # correct option - id: "b" text: "Option B" + --- + + - # True/False: +
+ Examples: type: true-false + + --- + questions: - id: "question2" - text: "This is a true/false question" - type: "single-answer" # choose the type + text: "Kubernetes Pods can contain multiple containers." + type: "true-false" # choose the type marks: 1 options: - id: "true" @@ -295,6 +302,7 @@ Instructions are defaultly defined for each question type : - single-answer: Select one answer - multiple-answers: Select all that apply - short-answer: Type your answer below +- true-false: Select True or False Instructions can be override in frontmatter by defining a custom intruction for each question. From df14de5405d6b2481904b36e7c8874ef2b69b09d Mon Sep 17 00:00:00 2001 From: Nouran Atef Date: Mon, 20 Oct 2025 17:50:02 +0300 Subject: [PATCH 6/6] update Signed-off-by: Nouran Atef --- .../index.md | 18 +++++------------- 1 file changed, 5 insertions(+), 13 deletions(-) diff --git a/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md b/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md index 82d4bd40b..25e7c3f0f 100644 --- a/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md +++ b/content/en/cloud/academy/creating-content/integrating-assessments-in-the-academy/index.md @@ -144,7 +144,7 @@ questions: | | `questions` | ✅ | An array containing one or more question objects. | | **Question Object** | `id` | ✅ | Unique identifier for the question within the assessment (e.g., `q1`, `q2`). | | | `text` | ✅ | The text of the question prompt. | -| | `type` | ✅ | The type of question. Accepted values are `single-answer`, `multiple-answers`, `short-answer`, or `true-false`. | +| | `type` | ✅ | The type of question. Accepted values are `single-answer`, `multiple-answers` or `short-answer`. | | | `marks` | ✅ | The number of points awarded for a correct answer. | | | `instructions` | - | Custom instruction for each question | | | `options` | - | An array of answer options. | @@ -155,7 +155,7 @@ Remember: `type: "test"` are fixed values that cannot be modified. The system ne ## Supported Assessment Types -Layer5 Academy supports four question formats: +Layer5 Academy supports three question formats: ***Single Choice Questions*** - Single correct answer @@ -177,18 +177,11 @@ Layer5 Academy supports four question formats: is_correct: true # correct option - id: "b" text: "Option B" - --- - -
-
- Examples: type: true-false - - --- - questions: + # True/False: - id: "question2" - text: "Kubernetes Pods can contain multiple containers." - type: "true-false" # choose the type + text: "This is a true/false question" + type: "single-answer" # choose the type marks: 1 options: - id: "true" @@ -302,7 +295,6 @@ Instructions are defaultly defined for each question type : - single-answer: Select one answer - multiple-answers: Select all that apply - short-answer: Type your answer below -- true-false: Select True or False Instructions can be override in frontmatter by defining a custom intruction for each question.