new pages to test

src/.vuepress/navbar.ts

@@ -10,7 +10,8 @@ export default navbar([
       { text: "Beginner Security Automation Developer Class", link: "/courses/beginner/", icon: "creative" },
       { text: "Advanced Security Automation Developer Class", link: "/courses/advanced/", icon: "creative" },
       { text: "Security Guidance Developer Class", link: "/courses/guidance/", icon: "creative" },
-      { text: "InSpec Profile Development & Testing", link: "/courses/profile-dev-test/", icon: "creative"}
+      { text: "InSpec Profile Development & Testing", link: "/courses/profile-dev-test/", icon: "creative"},
+      { text: "SAF Delta Class", link: "/courses/delta/", icon: "creative" },
     ]},
   { text: "Resources",
     icon: "book",

src/.vuepress/sidebar.ts

@@ -39,5 +39,13 @@ export default sidebar({
       children: "structure",
       collapsible: true
     },
+    {
+      icon: "creative",
+      text: "SAF Delta",
+      prefix: "courses/delta/",
+      children: "structure",
+      collapsible: true
+    },
+
   ],
 });

src/README.md

@@ -21,6 +21,9 @@ actions:
   - text: InSpec Profile Updating & Development
     link: /courses/profile-dev-test/
     type: primary
+  - text: SAF Delta
+    link: /courses/delta/
+    type: primary
 
 highlights:
   - header: What You Will Learn

src/courses/advanced/12.md

@@ -1,6 +1,7 @@
 ---
 order: 12
 title: 12. Next Steps
+next: 13.md
 author: Emily
 headerDepth: 3
 ---

src/courses/advanced/13.md

@@ -0,0 +1,8 @@
+---
+order: 13
+title: 13. Delta
+author: Daniel
+headerDepth: 3
+---
+
+## Testing

src/courses/delta/25.md

@@ -0,0 +1,66 @@
+---
+order: 25
+next: 26.md
+title: InSpec Delta - Laying the Ground for a Clean Release Branch
+shortTitle: Delta - Prep & Setup
+author: Aaron Lippold
+---
+
+## InSpec Delta
+
+### Preparing the Profile Before Running Delta
+
+Before running Delta, it's beneficial to format the profile to match the format Delta will use. This minimizes changes to only those necessary based on the guidance update. Follow these steps:
+
+1. **Run Cookstyle:** Install the Cookstyle gem and use it to lint the controls into Cookstyle format. Verify the gem installation with `gem list cookstyle`. Create a `.rubocop.yml` file with the provided example settings or modify these settings via the command line. Run `cookstyle -a ./controls` and any tests you have for your profile.
+
+```shell
+AllCops:
+  Exclude:
+    - "libraries/**/*"
+
+Layout/LineLength:
+  Max: 1000
+  AllowURI: true
+  IgnoreCopDirectives: true
+
+Naming/FileName:
+  Enabled: false
+
+Metrics/BlockLength:
+  Max: 400
+
+Lint/ConstantDefinitionInBlock:
+  Enabled: false
+
+# Required for Profiles as it can introduce profile errors
+Style/NumericPredicate:
+  Enabled: false
+
+Style/WordArray:
+  Description: "Use %w or %W for an array of words. (https://rubystyle.guide#percent-w)"
+  Enabled: false
+
+Style/RedundantPercentQ:
+  Enabled: true
+
+Style/NestedParenthesizedCalls:
+  Enabled: false
+
+Style/TrailingCommaInHashLiteral:
+  Description: "https://docs.rubocop.org/rubocop/cops_style.html#styletrailingcommainhashliteral"
+  Enabled: true
+  EnforcedStyleForMultiline: no_comma
+
+Style/TrailingCommaInArrayLiteral:
+  Enabled: true
+  EnforcedStyleForMultiline: no_comma
+
+Style/BlockDelimiters:
+  Enabled: false
+
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+```
+
+2. **Run the SAF CLI Command:** Use `saf generate update_controls4delta` to check and update the control IDs with the provided XCCDF guidance. This process checks if the new guidance changes the control numbers and updates them if necessary. This minimizes the Delta output content and improves the visualization of the modifications provided by the Delta process.

src/courses/delta/26.md

@@ -0,0 +1,47 @@
+---
+order: 26
+next: 27.md
+title: InSpec Delta - Making the Delta Release Branch
+shortTitle: Delta - Making your Branch
+author: Aaron Lippold
+---
+
+## Prepair Your Environment
+
+- **Download New Guidance:** Download the appropriate profile from the [DISA Document Library](https://public.cyber.mil/stigs/downloads/). Unzip the downloaded folder and identify the `<name>xccdf.xml` file.
+- **Create the InSpec Profile JSON File:** Clone or download the InSpec profile locally. Run the `inspec json` command to create the InSpec Profile JSON file to be used in the `saf generate delta` command.
+
+## Delta Workflow Process
+
+![Delta Workflow Process](https://user-images.githubusercontent.com/13986875/228628448-ad6b9fd9-d165-4e65-95e2-a951031d19e2.png "Delta Workflow Process Image")
+
+## Using Delta
+
+The SAF InSpec Delta workflow typically involves two phases, `preformatting` and `delta`.
+
+Before starting, ensure you have the latest SAF-CLI, the InSpec Profile JSON file, and the updated guidance file.
+
+1. **Preformat the Source Profile:** Before running the Delta command, preformat your source profile (usually the Patch Release profile) using the `saf generate update_controls4delta` command. This prepares the profile for the Delta process.
+2. **Run the Delta Command:** Execute `saf generate delta [arguments]` to start the Delta process.
+
+For more information on these commands, refer to the following documentation:
+
+- [update_controls4delta](https://saf-cli.mitre.org/#delta-supporting-options)
+- [saf generate delta](https://saf-cli.mitre.org/#delta)
+
+## Scope of Changes by Delta
+
+Delta focuses on specific modifications migrating the changes from the XCCDF Benchmark Rules to the Profiles controls, and updating the 'metadata' of each of thosin the `control ID`, `title`, `default desc`, `check text`, and `fix text`, between the XCCDF Benchmark Rules and the Profile Controls.
+
+If the XCCDF Guidance Document introduces a new 'Rule' or `inspec control` that is not in the current profile's `controls` directory, Delta will add it to the controls directory, populating the metadata from the XCCDF Benchmark data, similar to the [inspec_profile](#inspec-profile) (aliases xccdf-benchmark-to-inspec-stubs) tool.
+
+It also adjusts the `tags` and introduces a `ref` between the `impact` and `tags`.
+
+Delta does not modify the Ruby/InSpec code within the control, leaving it intact. Instead, it updates the 'control metadata' using the information from the supplied XCCDF guidance document. This applies to 'matched controls' between the XCCDF Guidance Document and the InSpec profile.
+
+### Further InSpec Delta Information and Background
+
+- The original Delta branch can be found [here](https://github.com/mitre/saf/pull/485).
+- Delta moves lines not labeled with 'desc' to the bottom, between tags and InSpec code.
+- Whether the controls are formatted to be 80 lines or not, Delta exhibits the same behavior with the extra text.
+- Parameterizing should be considered.