Feature improve documentation

[david-waltermire]

Committer Notes

This PR represents Metaschema specification improvements made during a full review and edit of the current Metaschema specification.

This PR will address the following issues:

• Add Documentation for Local Refinements for Metaschema Syntax #237 (partially addressed)
• Update Metaschema Syntax Documentation to Refer to Token Types, Not IDs #238
• Documentation of Scopes? #239
  • Explain scopes in terminology and/or syntax pages
  • Demonstrate through an example how @scope being local or global impacts processing of modules from //imports.
• Metaschema modeling docs corrections #310
• Formalize documentation of json-key json-key-value #316
• Metaschema RegEx Standard #325
  • Document the use of regular expression dialects in XML and JSON Schema.

Also addressed:

• Fixed a bug in the base64 data type causing values in the range g-z and +/= to not be valid.

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.

[wendellpiez]

Still working on it ...

[wendellpiez]

Looking good!

[nikitawootten-nist]

NB: I've found the right navigation sidebar to be pretty useless for the specification page:

There are too many headings to meaningfully navigate. Could the sidebar generator be adjusted to only generate entries up to a certain depth (ignore h3 and below)? Otherwise the page may be better served if the sidebar was disabled.

[wendellpiez]

Overall I didn't see much and some require judgement but perhaps not action.

Nice job!

[aj-stein-nist]

I found minor types or recommendations on possible stylistic improvement, but those are not important and for the most part subjective. Excellent work, I look forward to finish constraint docs, others areas, and applying what I have learned overall from these docs and put them to good use.