Basic Metaschema Tutorial

[aj-stein-nist]

Committer Notes

Add basic metaschema tutorial for #260.

All Submissions:

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?
• Have you squashed any non-relevant commits and commit messages? [instructions]
• Do all automated CI/CD checks pass?

Changes to Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your core changes, as applicable?
• Have you included examples of how to use your new feature(s)?
• Have you updated all website](https://pages.nist.gov/metaschema) and readme documentation affected by the changes you made? Changes to the website can be made in the website/content directory of your branch.

[aj-stein-nist]

@brianruf suggested collapsing the code samples (of the Metaschema definitions and equivalent instances) would increase the accessibility of this tutorial.

Brian opened this in response: #277. Thanks to him!

[aj-stein-nist]

Feedback from @brianruf and @jimstevensedc: this tutorial and/or potentially future tutorials should cover two perspectives, clearly and intentionally:

1. How you will write a tool to do the function covered in the tutorial (what we are doing now)
2. How we use existing tools (XSLT implementation, oscal-cli metaschema subcommand, others TBD) that can curretly exercise that function/use case as a user without writing your own (we do not cover this yet)

[aj-stein-nist]

@david-waltermire-nist also asked for me in a call to do the following before asking for re-review:

1. Add accordion style tab for instance examples in JSON, XML, YAML.
2. Add tutorial landing page in place of this page in PR, move tutorial to its own page, link to the relocated tutorial on the new landing page

[aj-stein-nist]

@david-waltermire-nist also asked for me in a call to do the following before asking for re-review:

1. Add accordion style tab for instance examples in JSON, XML, YAML.

2. Add tutorial landing page in place of this page in PR, move tutorial to its own page, link to the relocated tutorial on the new landing page

Ok @david-waltermire-nist, done and ready for review.

[aj-stein-nist]

The build failure, FYI, is waiting on #278 to build successfully in main.

[wendellpiez]

Looking good! Thanks AJ!

[wendellpiez]

Mostly suggesting corrections to typos with a couple more substantial offerings.

Bravo AJ!

[aj-stein-nist]

@wendellpiez I included all the feedback you provided in your previous review. I will do a final pass for minor typos, but I need you, @david-waltermire-nist, or @nikitawootten-nist. I might find a typo or two, but it is ready to go.

[wendellpiez]

Went over this together looking good!