From 1c278dd8dcf707c30b5d9e21279d69c89c686ddb Mon Sep 17 00:00:00 2001 From: Daniel Medina Date: Fri, 6 Dec 2024 08:55:25 -0500 Subject: [PATCH] adjust use case --- src/courses/delta/04.md | 32 +++++++------------------------- 1 file changed, 7 insertions(+), 25 deletions(-) diff --git a/src/courses/delta/04.md b/src/courses/delta/04.md index 6ed4def1d..da699bd3c 100644 --- a/src/courses/delta/04.md +++ b/src/courses/delta/04.md @@ -13,11 +13,11 @@ There are several situations that warrant the use of the delta process. These ar 2. [Use Case 2](#412-use-case-2) - Update control IDs based on group ID (run update controls) -3. [Use Case 3](#413-use-case-3) - Update controls but create a backup (run update controls) +3. [Use Case 3](#415-use-case-4) - Generate stubs for new controls found in the XCCDF Benchmark file (run Delta without fuzzy matching) + +4. [Use Case 4](#414-use-case-3) - No mappings were found using update controls (run Delta with fuzzy matching) -4. [Use Case 4](#414-use-case-4) - No mappings were found using update controls (run Delta with fuzzy matching) -5. [Use Case 5](#415-use-case-5) - Generate stubs for new controls found in the XCCDF Benchmark file (run Delta without fuzzy matching) ### 4.1.1 Use Case 1 @@ -35,36 +35,18 @@ If there isn't any mapping between baseline X and Y using the default rule ident [return to top](#41-use-cases-for-running-delta) -### 4.1.3 Use Case 3 - -Similar to Use Cases 1 and 2, this use case updates controls in baseline X with new controls identified in baseline Y based on selected indexed identification but also creates a backup of the modified controls. - -**Process:** Run `update_controls4delta` - -[return to top](#41-use-cases-for-running-delta) +### 4.1.4 Use Case 3 -### 4.1.4 Use Case 4 - -Running update controls may result in no controls being updated or no mappings being found from baseline X to baseline Y. This could be due to there being too many revisions or releases between the two baselines, creating no way to map between them. In this case, use Delta with fuzzy matching. +New guidance often contains new controls that weren't previously defined. In this case, running the delta process generates the control stubs with all metadata, except for the describe block (code) content. **Process:** Run `delta` [return to top](#41-use-cases-for-running-delta) -### 4.1.5 Use Case 5 +### 4.1.5 Use Case 4 -New guidance often contains new controls that weren't previously defined. In this case, running the delta process generates the control stubs with all metadata, except for the describe block (code) content. +Running update controls may result in no controls being updated or no mappings being found from baseline X to baseline Y. This could be due to the baselines belonging to different platforms, or too many revisions were released between the two baselines, creating no way to map between them. In this case, use Delta with fuzzy matching. **Process:** Run `delta` [return to top](#41-use-cases-for-running-delta) - -### Suggested Enhancements for Education and Training - -1. **Examples and Scenarios:** Provide real-world examples and scenarios for each use case to help students understand the practical applications. -2. **Interactive Exercises:** Include interactive exercises where students can practice running the commands (`update_controls4delta` and `delta`) in a controlled environment. -3. **Visual Aids:** Use flowcharts or diagrams to visually represent the processes described in each use case. -4. **Quizzes:** Add quizzes at the end of each section to reinforce learning and ensure comprehension. -5. **Glossary:** Include a glossary of terms used in the document to help students familiarize themselves with the terminology. -6. **Step-by-Step Guides:** Provide detailed, step-by-step guides for running the commands, including screenshots or terminal outputs to illustrate the expected results. -7. **Discussion Questions:** Add discussion questions at the end of each section to encourage critical thinking and group discussions.