Clarify scope and coverage of this site in readme

wendellpiez commented 4 years ago

Not all OSCAL tools are or can be in this repository. In particular, the OSCAL models are represented by schemas (XSD and JSON Schema, Schematron etc.) and serviced using generic tools such as the content converters.

The OSCAL web site also has a tools page.

On this site, a readme should point users to other locations for tools, including but not limited to those mentioned here.

This Issue can be closed if we have, minimally

[x] an explanation of (where to find) the official schemas and content converters
[x] other utilities in the main OSCAL repository we want users to be aware of?
[x] a link to the main site's Tools page, with an invitation to developers for listing there

wendellpiez commented 2 years ago

The readme could still use some more details as noted here. Assign to me?

wendellpiez commented 2 years ago

Actually, what this Issue implies is more like high level tutorial materials on where to find OSCAL Tools and how to use them ...

wendellpiez commented 1 year ago

Check out PR #70 addressing this Issue.

usnistgov / oscal-tools

Clarify scope and coverage of this site in readme #11