OSCAL icon indicating copy to clipboard operation
OSCAL copied to clipboard

"Tutorials" page enhancement

Open iMichaela opened this issue 3 years ago • 0 comments

User Story

As an OSCAL beginner, I would like to have clear description of all available tutorials introduced in a logical way and with sufficient guidance that allows me to progressivly learn the OSCAL models, how to use them to generate OSCAL instances (content) that I can use in conjuction with the existing OSCAL instances, in support of my organization's risk assessment and management.

Goals

The "Walkthrough Tutorials" page and its sub-pages are lacking a high-level introduction aligned with the Layers and Models page and a more comprehensive description of each tutorial.

Here is a suggested TOC:

1 - Core OSCAL Models 1.1 Common Elements 1.1.1 Creating and Using Metadata 1.1.x 1.2 Control Layer Topics 1.2.1 Creating a Basic Control Catalog 1.2.x ... 1.3 Implementation Layer Topics 1.3.1 Creating a Basic Component Definition 1.3.2 Representing test validation information 1.x

2 - Extending OSCAL Models

Dependencies

none

Acceptance Criteria

  • [ ] All OSCAL website and readme documentation affected by the changes in this issue have been updated. Changes to the OSCAL website can be made in the docs/content directory of your branch.
  • [ ] A Pull Request (PR) is submitted that fully addresses the goals of this User Story. This issue is referenced in the PR.
  • [ ] The CI-CD build process runs without any reported errors on the PR. This can be confirmed by reviewing that all checks have passed in the PR.

iMichaela avatar Aug 01 '22 02:08 iMichaela