Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Organize the documentation #25

Closed
kscarfone opened this issue Aug 26, 2017 · 18 comments
Closed

Organize the documentation #25

kscarfone opened this issue Aug 26, 2017 · 18 comments
Assignees
@wendellpiez @david-waltermire @kscarfone
Labels
LoE: Medium User Story
Milestone
OSCAL 1.0 Milesto...

Comments

@kscarfone
Copy link

kscarfone commented Aug 26, 2017 •
edited
Loading

As a content or tool developer, I can find well-organized information containing an overview of OSCAL's purpose, benefits, and uses; the high-level OSCAL architecture and components; and the composition of OSCAL's catalog schema.

Required Resources:

  • Text and graphics on OSCAL's purpose, benefits, and uses; high-level OSCAL architecture and components; and the composition of OSCAL's catalog schema

Goals:

  1. Plan how the documentation should be organized and reach core team consensus on the plan.
  2. Implement the plan so all documentation is clearly structured and linked together using formats such as HTML and Markdown that can import cleanly into Word, Powerpoint, and/or other appropriate production platforms.

Acceptance Criteria:

  1. Validate that all documentation is included in the new organization scheme and no content is unnecessarily duplicated.
  2. Be ready to share the reorganized documentation with Fred, Jaafar, and the tiger team for review.
@kscarfone kscarfone self-assigned this Aug 26, 2017
@kscarfone
Copy link
Author

Reminders:

  1. Set up a glossary.
  2. Pull extra material from readme.md files and integrate it with other documentation.

@kscarfone kscarfone changed the title Organize the documentation Sprint 4 candidate: Organize the documentation Sep 5, 2017
@david-waltermire
Copy link
Contributor

Karen, Wendell, and Dave will meet before our next (9/12) status call to design a documentation organizational approach to use going forward. We will share this with the team to get feedback.

@kscarfone kscarfone changed the title Sprint 4 candidate: Organize the documentation Organize the documentation Sep 5, 2017
@akarmel
Copy link
Contributor

akarmel commented Sep 12, 2017

9/12/2017 Sprint Review Call Notes

  • Will coordinate with Karen this week to start a conversation on this topic.

@kscarfone
Copy link
Author

Beginning work on this today. Edited the user story to drop the portions requiring the profile schema to be fully documented since that work will be happening in a later sprint.

@david-waltermire
Copy link
Contributor

Some of the cleanup that can be done here relates to issue #31. If we can complete that related work, we should close that issue.

@kscarfone
Copy link
Author

I propose the following organization for the documentation:

README.md files:

  1. OSCAL/README.md will become the top-level documentation. It will serve two purposes: to explain what the OSCAL repository contains at a high level, and to point people to other documentation files within the repository (Markdown, HTML, etc.) for information on OSCAL itself (purpose, benefits, uses, definitions, architecture, schema composition, etc.)
  2. All other README.md files in the repository would explain what their portions of the OSCAL repository contain and, optionally, point people to other files within the repository for additional documentation on aspects of OSCAL.
  3. This approach keeps the readme.md files short, provides quick access to the needed info, and avoids duplication of content in readme.md files and other documentation files.

Other Documentation Files in GitHub:

  1. Make other documentation files (in Markdown, HTML, etc.) modular. Having modular files instead of a single huge file makes it easier for people to find what they want, makes documentation authoring and maintenance easier for us, and simplifies automated conversion of the documentation to Word, Powerpoint, etc. Documentation files would contain pointers to other documentation files so people could easily get more info on related topics without having to search.
  2. We already have a good start on an OSCAL Overview document at OSCAL/docs/prose/OSCAL Overview.md. It defines terms and explains the problem OSCAL is solving, the main OSCAL components and architecture, the needs/roles of OSCAL users, the relationship between OSCAL catalog and profile models, expected OSCAL deliverable types, and long-term OSCAL goals. I recommend refining this document and transferring its content on the catalog-profile model relationship to another document, perhaps oscal-tag-library-md (see below).
  3. We can point people to OSCAL/working/doc/schema/oscal-tag-library.md for the latest info on schema composition.
  4. We have talked about doing a glossary. I'm wondering if it might be best to define terms in the tag library source (OSCAL/working/doc/schema/oscal-oscal.xml). Those will automatically flow to oscal-tag-library.md.

Feedback on this proposal would be appreciated. Thanks!

@akarmel
Copy link
Contributor

akarmel commented Sep 19, 2017

9/19/2017 - Sprint Review Call Notes

  • ACTION ITEM: Dave will setup a working session with Karen and Wendell this Friday from 12-3 to review this proposal and codify a path forward to complete this work prior to the end of the sprint.
  • Prose documentation should be moved into the docs folder
  • Dave will talk to Matt Scholl and then Ann Rickers (NIST Security Officer) to see if the NIST OSCAL GitHub site can be made a public repository

@wendellpiez
Copy link
Contributor

In addition to the above, I suggest we put any documentation that isn't tied to a subdirectory (to help people browsing the repo), up in /docs, where Github Pages will see it.

"Documentation" in this case may refer not only to explanatory prose, but copies of resources that we wish to be accessible on the open web (i.e. not just by downloading the repo).

Github page will render Markdown through a page template (we can pick one) which should do things like ToCs. This will help. When we need more than what the Markdown/Jekyll will give us, we can produce HTML (from/with templates as appropriate).

I guess I can start this process by setting up the schema docs pipeline to write into /docs...

@kscarfone
Copy link
Author

We had a call and reached consensus on the proposal. I will start implementing the proposal today.

@kscarfone
Copy link
Author

I have reorganized the prose on GitHub. Redundant material has been integrated or deleted. README.md files explain what their portions of the repository contain and, where relevant, point to separate prose documentation files for additional information.

There are three items remaining to be addressed. I will talk to Wendell about these.

  1. The page at docs/schema/oscal-tag-library.md needs retitled. Can we call it something like "OSCAL Schema Composition" instead of just OSCAL? If that's OK, I can alter the phrase in docs/schema/oscal-oscal.xml that the tag library is generated from.
  2. Do we need to add a readme.md file to working/lib, or is it obvious to repository users what's where?
  3. Should FedRAMP and CSF be added to working/README.md?

@wendellpiez
Copy link
Contributor

wendellpiez commented Sep 22, 2017 •
edited
Loading

@kscarfone I can take care of question 1 for you - since I have edits to make to oscal-oscal.xml I will just add this one (and produce fresh HTML and .md files).

I can also take care of the others too of course (although I am no good judge of what's obvious).

wendellpiez added a commit that referenced this issue Sep 22, 2017
@wendellpiez
More adjustments to schema docs (#25)
cd3d067
@wendellpiez
Copy link
Contributor

With latest commits oscal-tag-library.md is updated and I continue to make tweaks --

@kscarfone
Copy link
Author

Thanks, Wendell, your changes look great. As far as I'm concerned, this work has been completed

@akarmel
Copy link
Contributor

akarmel commented Sep 25, 2017 •
edited
Loading

9/19/2017 - Sprint Review Call Notes

REMAINING ACTION ITEMS TO COMPLETE PRIOR TO THE END OF THE SPRINT

  • Need a readme in the docs folder that explains what each folder is for
  • Schema-Decisions.md should be in the tag library as opposed to a separate document
    • Wendell will take a shot at taking this apart and moving it to the tag library
  • Need documentation on how to use schematron and for schema collection process
    • Should create a "build.md" file
  • USER STORY FOR THE NEXT SPRINT: We have two types of documentation to produce, one for the implementer/end user and one for the maintainer.  Should create markdown files for each of these audiences.  For end user, walk the user through how they would use OSCAL (e.g walk user through basic document creation).

@kscarfone
Copy link
Author

I have created a readme.md in the docs folder that explains the contents of each subfolder.

wendellpiez added a commit that referenced this issue Sep 27, 2017
@wendellpiez
Revs to high level docs and oscal-oscal.xml (issue #25)
d4355c1
@wendellpiez
Copy link
Contributor

I have just removed Schema-Decisions.md and integrated its copy (or whatever I thought worth keeping) into oscal-oscal.xml (refreshing schemas and schema docs while doing so).

I haven't yet done much to document how to use / apply the Schematrons (especially to anyone new to XML-based document processing). So far I have used them only inside the IDE (while the tech is standards-based and should run outside no problem). To a great extent, whether a user wants / needs any Schematron (and which) depends on the use case (as already noted on this ticket). Probably it's not just the Schematron but the entire "layered validation model" that needs to be documented (see also #46). One might expect that many OSCAL users and even devs may not have any concern for the Schematron, if the catalogs they are referencing are "always already" valid and correct (and known to be) - in which case it may be more important to document what the Schematrons do (for the data), than how to run and apply them. While for others (framework developers?) the Schematrons may be super-useful for edit-time QA of OSCAL. I think we need more user stories to dovetail with the Schematron demos.

I've also updated /working/lib/XSD/readme.md to describe the schema production pipeline including the steps for creating the XSDs and generating the documentation. It could say more about how to run the process, while at the same time it isn't clear who the user is of these particular docs (who is expected to be modifying and documenting the core schema files?). It already does say more (and better) about what the files are and how they relate, to help devs who are just trying to trace and follow. (Also the files themselves have been refactored somewhat for clarity cf Issue #49.)

@kscarfone
Copy link
Author

Thanks, Wendell, I just took a look at the docs you updated and they're in good shape. As you say, we should plan on having user stories in future sprints for developing additional documentation.

@akarmel
Copy link
Contributor

akarmel commented Oct 24, 2017

10/24/2017 - Sprint Review Call Notes

  • Complete. Room for improvement for organization of examples

@akarmel akarmel closed this as completed Oct 24, 2017
david-waltermire added a commit that referenced this issue Apr 3, 2018
@david-waltermire
# This is a combination of 29 commits.
5b13d9d 
# The first commit's message is:

# This is a combination of 54 commits.
# The first commit's message is:

# This is a combination of 4 commits.
# The first commit's message is:

# This is a combination of 2 commits.
# The first commit's message is:

# This is a combination of 2 commits.
# The first commit's message is:

# This is a combination of 6 commits.
# The first commit's message is:

# This is a combination of 3 commits.
# The first commit's message is:

# This is a combination of 111 commits.
# The first commit's message is:

Initial commit of docs branch.

# This is the commit message #2:

Create CONTRIBUTING.md
# This is the commit message #3:

Create ROADMAP.md
# This is the commit message #4:

Update README.md
# This is the commit message #5:

Create README.md
# This is the commit message #6:

Update README.md
# This is the commit message #7:

Update README.md
# This is the commit message #8:

Create OSCAL-PRODUCERS.md
# This is the commit message #9:

Create OSCAL-CONSUMERS.md
# This is the commit message #10:

Update and rename OSCAL-CONSUMERS.md to USERS.md
# This is the commit message #11:

Update and rename OSCAL-PRODUCERS.md to IMPLEMENTERS.md
# This is the commit message #12:

Rename CONTRIBUTING.md to CONTRIBUTORS.md
# This is the commit message #13:

Update README.md
# This is the commit message #14:

Update README.md
# This is the commit message #15:

Update USERS.md
# This is the commit message #16:

Update README.md
# This is the commit message #17:

Update IMPLEMENTERS.md
# This is the commit message #18:

Update README.md
# This is the commit message #19:

Update ROADMAP.md
# This is the commit message #20:

Update USERS.md
# This is the commit message #21:

Update CONTRIBUTORS.md
# This is the commit message #22:

Update README.md
# This is the commit message #23:

Update README.md
# This is the commit message #24:

Update IMPLEMENTERS.md
# This is the commit message #25:

Update IMPLEMENTERS.md
# This is the commit message #26:

Rename CONTRIBUTORS.md to CONTRIBUTING.md
# This is the commit message #27:

Create control.md
# This is the commit message #28:

Update control.md
# This is the commit message #29:

Update control.md
# This is the commit message #30:

Update control.md
# This is the commit message #31:

Update control.md
# This is the commit message #32:

Add files via upload
# This is the commit message #33:

Update control.md
# This is the commit message #34:

Create temp.md
# This is the commit message #35:

Delete NIST-SP-800-53-Rev4-AC1.png
# This is the commit message #36:

Add files via upload
# This is the commit message #37:

Delete temp.md
# This is the commit message #38:

Add files via upload
# This is the commit message #39:

Update control.md
# This is the commit message #40:

Add files via upload
# This is the commit message #41:

Add files via upload
# This is the commit message #42:

Update control.md
# This is the commit message #43:

Update CONTRIBUTING.md
# This is the commit message #44:

Update CONTRIBUTING.md
# This is the commit message #45:

Update USERS.md
# This is the commit message #46:

Update CONTRIBUTING.md
# This is the commit message #47:

Delete CONTRIBUTING.md
# This is the commit message #48:

Delete USERS.md
# This is the commit message #49:

Add files via upload
# This is the commit message #50:

Delete CSA-CCM-IAM02.png
# This is the commit message #51:

Update control.md
# This is the commit message #52:

Update control.md
# This is the commit message #53:

Update control.md
# This is the commit message #54:

Update control.md
# This is the commit message #55:

Update control.md
# This is the commit message #56:

Update control.md
# This is the commit message #57:

Update control.md
# This is the commit message #58:

Update control.md
# This is the commit message #59:

Update control.md
# This is the commit message #60:

Update control.md
# This is the commit message #61:

Delete NIST-SP-800-53-AC1-in-OSCAL-XML.png
# This is the commit message #62:

Update README.md
# This is the commit message #63:

Update control.md
# This is the commit message #64:

Update control.md
# This is the commit message #65:

Add files via upload
# This is the commit message #66:

Delete ISO-27001-Control-A9.png
# This is the commit message #67:

Update control.md
# This is the commit message #68:

Add files via upload
# This is the commit message #69:

Add files via upload
# This is the commit message #70:

Delete ISO-27002-Control-9.1.1-part1.png
# This is the commit message #71:

Delete ISO-27002-Control-9.1.1-part2.png
# This is the commit message #72:

Update control.md
# This is the commit message #73:

Update control.md
# This is the commit message #74:

Update control.md
# This is the commit message #75:

Update control.md
# This is the commit message #76:

Update control.md
# This is the commit message #77:

Update README.md
# This is the commit message #78:

Update IMPLEMENTERS.md
# This is the commit message #79:

Add files via upload
# This is the commit message #80:

Delete oscal-layers.png
# This is the commit message #81:

Add files via upload
# This is the commit message #82:

Delete oscal-layers.png
# This is the commit message #83:

Add files via upload
# This is the commit message #84:

Update IMPLEMENTERS.md
# This is the commit message #85:

Update control.md
# This is the commit message #86:

Update IMPLEMENTERS.md
# This is the commit message #87:

Update control.md
# This is the commit message #88:

Rename IMPLEMENTERS.md to docs/prose/IMPLEMENTERS.md
# This is the commit message #89:

Rename IMPLEMENTERS.md to implementers.md
# This is the commit message #90:

Rearranged and outlined catalog documentation based on the conversation with karen and Wendell.

# This is the commit message #91:

Create catalog-xml.md
# This is the commit message #92:

Rename control.md to catalog.md
# This is the commit message #93:

Update catalog.md
# This is the commit message #94:

Update catalog.md
# This is the commit message #95:

Update catalog.md
# This is the commit message #96:

Update catalog-xml.md
# This is the commit message #97:

Update catalog-xml.md
# This is the commit message #98:

Update catalog-xml.md
# This is the commit message #99:

Update catalog-xml.md
# This is the commit message #100:

Update catalog-xml.md
# This is the commit message #101:

Update catalog-xml.md
# This is the commit message #102:

Update catalog-xml.md
# This is the commit message #103:

Update catalog-xml.md
# This is the commit message #104:

Update catalog-xml.md
# This is the commit message #105:

Update catalog-xml.md
# This is the commit message #106:

Docset migration to Slate

# This is the commit message #107:

Removing unused file.

# This is the commit message #108:

Update README.md

Corrected a typo
# This is the commit message #109:

Add files via upload

Graphical representation of OSCAL schemas aligned with Risk Management Framework steps and tasks.
# This is the commit message #110:

Create CONTRIBUTING.md
# This is the commit message #111:

Create ROADMAP.md
# This is the commit message #2:

Create README.md
# This is the commit message #3:

Update README.md
# This is the commit message #2:

Create OSCAL-PRODUCERS.md
# This is the commit message #3:

Create OSCAL-CONSUMERS.md
# This is the commit message #4:

Update and rename OSCAL-CONSUMERS.md to USERS.md
# This is the commit message #5:

Update and rename OSCAL-PRODUCERS.md to IMPLEMENTERS.md
# This is the commit message #6:

Rename CONTRIBUTING.md to CONTRIBUTORS.md
# This is the commit message #2:

Update USERS.md
# This is the commit message #2:

Update IMPLEMENTERS.md
# This is the commit message #2:

Update ROADMAP.md
# This is the commit message #3:

Update USERS.md
# This is the commit message #4:

Update CONTRIBUTORS.md
# This is the commit message #2:

Update IMPLEMENTERS.md
# This is the commit message #3:

Update IMPLEMENTERS.md
# This is the commit message #4:

Rename CONTRIBUTORS.md to CONTRIBUTING.md
# This is the commit message #5:

Create control.md
# This is the commit message #6:

Update control.md
# This is the commit message #7:

Update control.md
# This is the commit message #8:

Update control.md
# This is the commit message #9:

Update control.md
# This is the commit message #10:

Add files via upload
# This is the commit message #11:

Update control.md
# This is the commit message #12:

Create temp.md
# This is the commit message #13:

Delete NIST-SP-800-53-Rev4-AC1.png
# This is the commit message #14:

Add files via upload
# This is the commit message #15:

Delete temp.md
# This is the commit message #16:

Add files via upload
# This is the commit message #17:

Update control.md
# This is the commit message #18:

Add files via upload
# This is the commit message #19:

Add files via upload
# This is the commit message #20:

Update control.md
# This is the commit message #21:

Update CONTRIBUTING.md
# This is the commit message #22:

Update CONTRIBUTING.md
# This is the commit message #23:

Update USERS.md
# This is the commit message #24:

Update CONTRIBUTING.md
# This is the commit message #25:

Delete CONTRIBUTING.md
# This is the commit message #26:

Delete USERS.md
# This is the commit message #27:

Add files via upload
# This is the commit message #28:

Delete CSA-CCM-IAM02.png
# This is the commit message #29:

Update control.md
# This is the commit message #30:

Update control.md
# This is the commit message #31:

Update control.md
# This is the commit message #32:

Update control.md
# This is the commit message #33:

Update control.md
# This is the commit message #34:

Update control.md
# This is the commit message #35:

Update control.md
# This is the commit message #36:

Update control.md
# This is the commit message #37:

Update control.md
# This is the commit message #38:

Update control.md
# This is the commit message #39:

Delete NIST-SP-800-53-AC1-in-OSCAL-XML.png
# This is the commit message #40:

Update README.md
# This is the commit message #41:

Update control.md
# This is the commit message #42:

Update control.md
# This is the commit message #43:

Add files via upload
# This is the commit message #44:

Delete ISO-27001-Control-A9.png
# This is the commit message #45:

Update control.md
# This is the commit message #46:

Add files via upload
# This is the commit message #47:

Add files via upload
# This is the commit message #48:

Delete ISO-27002-Control-9.1.1-part1.png
# This is the commit message #49:

Delete ISO-27002-Control-9.1.1-part2.png
# This is the commit message #50:

Update control.md
# This is the commit message #51:

Update control.md
# This is the commit message #52:

Update control.md
# This is the commit message #53:

Update control.md
# This is the commit message #54:

Update control.md
# This is the commit message #2:

Update IMPLEMENTERS.md
# This is the commit message #3:

Add files via upload
# This is the commit message #4:

Delete oscal-layers.png
# This is the commit message #5:

Add files via upload
# This is the commit message #6:

Delete oscal-layers.png
# This is the commit message #7:

Add files via upload
# This is the commit message #8:

Update IMPLEMENTERS.md
# This is the commit message #9:

Update control.md
# This is the commit message #10:

Update IMPLEMENTERS.md
# This is the commit message #11:

Update control.md
# This is the commit message #12:

Rename IMPLEMENTERS.md to docs/prose/IMPLEMENTERS.md
# This is the commit message #13:

Rename IMPLEMENTERS.md to implementers.md
# This is the commit message #14:

Rearranged and outlined catalog documentation based on the conversation with karen and Wendell.

# This is the commit message #15:

Create catalog-xml.md
# This is the commit message #16:

Rename control.md to catalog.md
# This is the commit message #17:

Update catalog.md
# This is the commit message #18:

Update catalog.md
# This is the commit message #19:

Update catalog.md
# This is the commit message #20:

Update catalog-xml.md
# This is the commit message #21:

Update catalog-xml.md
# This is the commit message #22:

Update catalog-xml.md
# This is the commit message #23:

Update catalog-xml.md
# This is the commit message #24:

Update catalog-xml.md
# This is the commit message #25:

Update catalog-xml.md
# This is the commit message #26:

Update catalog-xml.md
# This is the commit message #27:

Update catalog-xml.md
# This is the commit message #28:

Update catalog-xml.md
# This is the commit message #29:

Fixed typos, updated repo documentation, and migrated documentation for use in Slate.

Corrected a typo (+4 squashed commit)

Squashed commit:

[6ada57f] Removing unused file.

[503ad71] Docset migration to Slate

[351257e] Update catalog-xml.md

[aae1e8b] Add files via upload

Graphical representation of OSCAL schemas aligned with Risk Management Framework steps and tasks.
david-waltermire added a commit that referenced this issue Apr 5, 2018
@david-waltermire
Added comment template.
e81253b 
renamed file.

Cleaning up scraps (and checking setup)

Initial work modeling 'framework' for profiling functionality

More improvements supporting framework (profile) example

More adjustments to framework (profile) example

Touchups to framework strawman

Improvements to profiling (design and demo)

Updated OSCAL namespace

Fine adjustments for profiles especially regarding subcontrols

First efforts at FedRAMP mapping

More adjustments

More adjustments to profiling including SP80-53 baselines as profiles (provisional)

Slight improvement in logic just in case

Much development on profiling

More adjustments to profile examples and resolution including preventing infinite recursion in profile resolution

Superseded by profile resolver XSLT

FedRAMP misc

CSF stuff mainly

Touchups mostly

Adjustments in integration and display (CSF example mainly)

Rearranging schema docs

Cleanup

Misc improvements, touchups, reorg

Linking README.md to OSCAL Overview.md

Rename OSCAL Overview.md to OSCAL-Overview.md

Update README.md

Update README.md

Transferred/integrated content from main README.md

Moved content to docs/prose/OSCAL-Overview.md

Added pointer to tag library, resequenced material

Update README.md

Create Profile-Catalog-Relationship.md

Linked to the new Profile-Catalog-Relationship.md

Create Schema-Decisions

Rename Schema-Decisions to Schema-Decisions.md

Update README.md

Update README.md

Update OSCAL-Overview.md

More adjustments to schema docs (#25)

A couple of more or less misleading points now corrected

More updates

Moved documentation inside working, eliminating working/doc branch also adjustments to readmes

Amended and improved some high-level discussion

FedRAMP demo adjustments incl temporary readme

Fixed typo

Added presentation Dave made on 10.17.2017.

Correcting small bug in profile extraction

Many files rearranged also more dev on framework analysis

Touchups

New XSLT now runs assessment of a nominal 'worksheet' framework document producing a copy with links and annotations

Revs to high level docs and oscal-oscal.xml (issue #25)

Create README.md

Removed quotes

Mainly demo files for profiling implementation

Renaming in FedRAMP example to reduce confusion

More improvements and clarifications in demo

More adjustments incl filenames; new XSLT producing profile from linked worksheet

Schematron supporting worksheet editing

More adjustments to FedRAMP, schemas

More readme adjustments

More slight adjustments to schema setup

Added rev5 draft controls and moved rev4 to a new directory for better organization.

Added 800-53 schema version 2.0.

Wrapup on Sprint 4

Now UTF-8

Added feed container schema.

Tweaked to validate

Created schema directories for OSCAL XML and JSON schema.

Restructuring SP800-53 working dir

Updates to SP800-53 stuff for rev5

More refinements

Adjustments for SP800-53 rev5 OSCAL conversion

More Fedramp analysis including restructuring

Mini testing catalog

JSON under XSLT3 tinkering

Adjustments for capturing rev5

Fedramp mapping updates

Removing process litter

Schema and schema process updates

Now presenting profile demos

Rearranging schema files

Updated readme

Minor adjustments

Many improvements and adjustments including an implementation of patching in profiles

Improvements in resolution and rendering

Edits to samples and readmes

More unit tests

Another example

Schema adjustments; updated schema docs now describes profiling elements

Preliminary FedRAMP analysis

Standalone OSCAL SP800-53 rev4 and its baselines now in /examples

Refinements

SP800-53 updates

Improvements to profiling Schematron w/ mini-testing

Production pipeline adjustments

Ran fresh for some catalog adjustments

More detail on examples/mini-testing readme

Mini testing refresh

FEDRamp HIGHT baseline analysis with XSLTs

Refinements and reorganization to FedRAMP (preliminary) profile extraction

More refinements and polishing of FedRAMP examples

Further adjustments to profile examples

Further improvements to readme

Refresh

Adjustments in view of #64

Keeping profile schema in line w/ changes in core

Starting on hand adjustments to FedRAMP

Extending profiles Schematron to detect when profiles can/should use exclude instead of include

More updates and name changes

More minor adjustments (more of them and more minor)

Cleanup mostly

Improvements to tag library docs

Updating docs

Trying again (testing Github md alas)

More FedRAMP readme

More small edits

Touches
david-waltermire pushed a commit that referenced this issue Apr 5, 2018
@wendellpiez @david-waltermire
# This is a combination of 60 commits.
840961c 
# The first commit's message is:

Restructuring for new initiative

Moved everything into 'old' and added a new subdirectory for new
experiments.

More early iteration over names

More adjustments in names mostly

HTML page for Word import testing

Just touchups this time

Updates and misc improvements

Changed document element to 'catalog'

Improved and renamed mapping transformation

Adjustments to models, schema, Schematron

Managing gitignore

Same

Minor adjustments

First cut at 27K mapping into OSCAL

Renamed directories for consistency

Cleanup

Bit more cleanup

Adjustments to mapping

Same

Numerous enhancements, some reorg

Planning notes

Added starter FO XSLT

First cut at FO XSL

Minor improvements

Small adjustments

Many/much schema enhancements; proto XSD version

First cut at inline declarations with live validation

Implementing declarations; styling

Refinements and extensions; new assign, select, withdrawn elements

More support for parameters etc.

Now implementing parameters etc.

More touches

Misc improvements

Sundry adjustments

Many more small improvements

Much documentation

More touchups

Updates

Misc adjustments and notes

Significant rework following design session esp declarations

More improvements incl extending declarations to groups

More adjustments; now mapping SP800-53A also.

More polishing and maintenance

Much more including hierarchical number checking

Adjustments, extensions, corrections

Name changes in the model

More adjustments

Cleanup of obsolete artifacts

Minor alignment

Mostly CSS, also Schematron improvements

ISO27002 mapping document

Many enhancements; new COBIT 5 mappings

More on COBIT

Improvements to mapping docs

Adjustments to mappings incl HTML versions

Moved screenshot for documentation

More adjustments and docs

Mostly improvements to documentation

Refreshed 800-53 data with adjustments

More general improvements to models and mappings

Continuing refinements to validations in samples

Update README.md

Update README.md

Update README.md

Update README.md

Minor tweaks

Including initial cut at profiling (1st, rule-based control extraction) among other refinements and improvements

No longer extant

Added new control to COBIT5 example

Misc improvements including more COBIT5 support

File rename and further adjustments

Misc adjustment; SaxonJS demo files

Misc adjustments

Updated readme contents to reflect merge.

Fixed links.

Changed text to better reflect current state and to add more links.

Rearrangement and cleanup

Schematron and schema adjustment and refactoring

SP800-53 extraction improvement, enhancement, cleanup

Improvements and enhancements to ISO27002 extraction

OSCAL Documentation

COBIT5 example tweakage

Organizational notes

Adjustments

Removed old files directory.
Moved files from draft to root.

Updated README.md to reflect new pathing.

Updated readme to contain more documentation of the OSCAL layers.

Added documentation for the working directory.

Update README.md

Edited the text.

Update README.md

Edited the text.

Added Aug 10 tiger team slides with notes

Create a prose overview of OSCAL

Update OSCAL Overview.md

Update OSCAL Overview.md

Profile and catalog mapping: a trivial example

Replacing graphic with rescaled version

Update OSCAL Overview.md

Rescaled image

Update OSCAL Overview.md

Mods to oXygen project file

Removing 'demo' (till later)

Moved proprietary file

Refinements to ISO27002 mappings (new model)

Refining SP800-53 conversion/mappings

Updating lib support for new model

Top-level org

Draft readme docs

Further adjustment to directory readme.md

More adjustments to ISO 27002 and SP800-53 (new model etc.)

More cleanup to main sample subdirectories + readme tweakage

Mostly restructuring

More adjustments to extraction, parameter support

Includes more model refinements; draft implementation of parameter resolution

Adjustments for revised models

Adjustments to demos and conversion pipelines

Experimenting with profiles

Infrastructure adjustments

Schema modifications

# This is the commit message #2:

Minor correction to schema docs merge
# This is the commit message #3:

Updating XSD w/ docs
# This is the commit message #4:

More element renaming/adjustment
# This is the commit message #5:

Now a stable schema again? With SP800-53 extraction adjustments
# This is the commit message #6:

Profile-related mods

# This is the commit message #7:

Org stuff

# This is the commit message #8:

Moved mappind docs; added readme
# This is the commit message #9:

schema documentation
# This is the commit message #10:

Schema production and documentation pipeline
# This is the commit message #11:

More reorg; tweaked schema; more docs
# This is the commit message #12:

Improvements to tag library
# This is the commit message #13:

Another attempt at internal links in md
# This is the commit message #14:

trying again
# This is the commit message #15:

Gonna get this eventually
# This is the commit message #16:

More updates and tuneups
# This is the commit message #17:

More updates to schema and docs
# This is the commit message #18:

Lighter adjustments
# This is the commit message #19:

Similarly subtle adjustments
# This is the commit message #20:

Adjustments supporting parameter assignments
# This is the commit message #21:

More docs
# This is the commit message #22:

Enhancements to demo
# This is the commit message #23:

Moving distractions out of the way
# This is the commit message #24:

Slight readme tweakage
# This is the commit message #25:

Tag library tweaks
# This is the commit message #26:

More tag library adjustments
# This is the commit message #27:

New readme for Schematrons
# This is the commit message #28:

Adjustments to readme
# This is the commit message #29:

Adjustments to mapping documents
# This is the commit message #30:

Adjustments to readme
# This is the commit message #31:

More adjustments to mapping documents
# This is the commit message #32:

Updated punchlist
# This is the commit message #33:

Updates to mapping docs
# This is the commit message #34:


# This is the commit message #35:

CSS for local editing of OSCAL OSCAL
# This is the commit message #36:

Slight adjustments
# This is the commit message #37:

Light editing
# This is the commit message #38:

Light editing
# This is the commit message #39:

Light edits
# This is the commit message #40:

Light edits
# This is the commit message #41:

Light edits
# This is the commit message #42:

Light edits
# This is the commit message #43:

More work on profiles
# This is the commit message #44:

Revised directory descriptions
# This is the commit message #45:

Added an explanation of the demo directories
# This is the commit message #46:

More on profiling
# This is the commit message #47:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #48:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #49:

Edits to schema documentation
# This is the commit message #50:

More enhancements to tag library and its presentation
# This is the commit message #51:

Internal links?
# This is the commit message #52:

Slight adjustments
# This is the commit message #53:

Further touchups to schema docs and their HTML rendering
# This is the commit message #54:

Support for 'pre'
# This is the commit message #55:

Rearranged and touched up profile experiments
# This is the commit message #56:

More touchups to tag library (linking)
# This is the commit message #57:

More adjustments to copy
# This is the commit message #58:

More adjustments
# This is the commit message #59:

Correcting display bug failing to render chars in CSS
# This is the commit message #60:

Added a PDF with the notes.
@david-waltermire david-waltermire added this to the OSCAL 1.0 M1 milestone Apr 6, 2018
david-waltermire pushed a commit that referenced this issue Apr 13, 2018
@wendellpiez @david-waltermire
# This is a combination of 3 commits.
5131631 
# The first commit's message is:

# This is a combination of 60 commits.
# The first commit's message is:

# This is a combination of 17 commits.
# The first commit's message is:

Restructuring for new initiative

Moved everything into 'old' and added a new subdirectory for new
experiments.

More early iteration over names

More adjustments in names mostly

HTML page for Word import testing

Just touchups this time

Updates and misc improvements

Changed document element to 'catalog'

Improved and renamed mapping transformation

Adjustments to models, schema, Schematron

Managing gitignore

Same

Minor adjustments

First cut at 27K mapping into OSCAL

Renamed directories for consistency

Cleanup

Bit more cleanup

Adjustments to mapping

Same

Numerous enhancements, some reorg

Planning notes

Added starter FO XSLT

First cut at FO XSL

Minor improvements

Small adjustments

Many/much schema enhancements; proto XSD version

First cut at inline declarations with live validation

Implementing declarations; styling

Refinements and extensions; new assign, select, withdrawn elements

More support for parameters etc.

Now implementing parameters etc.

More touches

Misc improvements

Sundry adjustments

Many more small improvements

Much documentation

More touchups

Updates

Misc adjustments and notes

Significant rework following design session esp declarations

More improvements incl extending declarations to groups

More adjustments; now mapping SP800-53A also.

More polishing and maintenance

Much more including hierarchical number checking

Adjustments, extensions, corrections

Name changes in the model

More adjustments

Cleanup of obsolete artifacts

Minor alignment

Mostly CSS, also Schematron improvements

ISO27002 mapping document

Many enhancements; new COBIT 5 mappings

More on COBIT

Improvements to mapping docs

Adjustments to mappings incl HTML versions

Moved screenshot for documentation

More adjustments and docs

Mostly improvements to documentation

Refreshed 800-53 data with adjustments

More general improvements to models and mappings

Continuing refinements to validations in samples

Update README.md

Update README.md

Update README.md

Update README.md

Minor tweaks

Including initial cut at profiling (1st, rule-based control extraction) among other refinements and improvements

No longer extant

Added new control to COBIT5 example

Misc improvements including more COBIT5 support

File rename and further adjustments

Misc adjustment; SaxonJS demo files

Misc adjustments

Updated readme contents to reflect merge.

Fixed links.

Changed text to better reflect current state and to add more links.

Rearrangement and cleanup

Schematron and schema adjustment and refactoring

SP800-53 extraction improvement, enhancement, cleanup

Improvements and enhancements to ISO27002 extraction

OSCAL Documentation

COBIT5 example tweakage

Organizational notes

Adjustments

Removed old files directory.
Moved files from draft to root.

Updated README.md to reflect new pathing.

Updated readme to contain more documentation of the OSCAL layers.

Added documentation for the working directory.

Update README.md

Edited the text.

Update README.md

Edited the text.

Added Aug 10 tiger team slides with notes

Create a prose overview of OSCAL

Update OSCAL Overview.md

Update OSCAL Overview.md

Profile and catalog mapping: a trivial example

Replacing graphic with rescaled version

Update OSCAL Overview.md

Rescaled image

Update OSCAL Overview.md

Mods to oXygen project file

Removing 'demo' (till later)

# This is the commit message #2:

Moved proprietary file

# This is the commit message #3:

Refinements to ISO27002 mappings (new model)

# This is the commit message #4:

Refining SP800-53 conversion/mappings

# This is the commit message #5:

Updating lib support for new model

# This is the commit message #6:

Top-level org

# This is the commit message #7:

Draft readme docs

# This is the commit message #8:

Further adjustment to directory readme.md

# This is the commit message #9:

More adjustments to ISO 27002 and SP800-53 (new model etc.)

# This is the commit message #10:

More cleanup to main sample subdirectories + readme tweakage

# This is the commit message #11:

Mostly restructuring

# This is the commit message #12:

More adjustments to extraction, parameter support

# This is the commit message #13:

Includes more model refinements; draft implementation of parameter resolution

# This is the commit message #14:

Adjustments for revised models

# This is the commit message #15:

Adjustments to demos and conversion pipelines

# This is the commit message #16:

Experimenting with profiles

# This is the commit message #17:

Infrastructure adjustments

# This is the commit message #2:

Minor correction to schema docs merge
# This is the commit message #3:

Updating XSD w/ docs
# This is the commit message #4:

More element renaming/adjustment
# This is the commit message #5:

Now a stable schema again? With SP800-53 extraction adjustments
# This is the commit message #6:

Profile-related mods

# This is the commit message #7:

Org stuff

# This is the commit message #8:

Moved mappind docs; added readme
# This is the commit message #9:

schema documentation
# This is the commit message #10:

Schema production and documentation pipeline
# This is the commit message #11:

More reorg; tweaked schema; more docs
# This is the commit message #12:

Improvements to tag library
# This is the commit message #13:

Another attempt at internal links in md
# This is the commit message #14:

trying again
# This is the commit message #15:

Gonna get this eventually
# This is the commit message #16:

More updates and tuneups
# This is the commit message #17:

More updates to schema and docs
# This is the commit message #18:

Lighter adjustments
# This is the commit message #19:

Similarly subtle adjustments
# This is the commit message #20:

Adjustments supporting parameter assignments
# This is the commit message #21:

More docs
# This is the commit message #22:

Enhancements to demo
# This is the commit message #23:

Moving distractions out of the way
# This is the commit message #24:

Slight readme tweakage
# This is the commit message #25:

Tag library tweaks
# This is the commit message #26:

More tag library adjustments
# This is the commit message #27:

New readme for Schematrons
# This is the commit message #28:

Adjustments to readme
# This is the commit message #29:

Adjustments to mapping documents
# This is the commit message #30:

Adjustments to readme
# This is the commit message #31:

More adjustments to mapping documents
# This is the commit message #32:

Updated punchlist
# This is the commit message #33:

Updates to mapping docs
# This is the commit message #34:

# This is the commit message #35:

CSS for local editing of OSCAL OSCAL
# This is the commit message #36:

Slight adjustments
# This is the commit message #37:

Light editing
# This is the commit message #38:

Light editing
# This is the commit message #39:

Light edits
# This is the commit message #40:

Light edits
# This is the commit message #41:

Light edits
# This is the commit message #42:

Light edits
# This is the commit message #43:

More work on profiles
# This is the commit message #44:

Revised directory descriptions
# This is the commit message #45:

Added an explanation of the demo directories
# This is the commit message #46:

More on profiling
# This is the commit message #47:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #48:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #49:

Edits to schema documentation
# This is the commit message #50:

More enhancements to tag library and its presentation
# This is the commit message #51:

Internal links?
# This is the commit message #52:

Slight adjustments
# This is the commit message #53:

Further touchups to schema docs and their HTML rendering
# This is the commit message #54:

Support for 'pre'
# This is the commit message #55:

Rearranged and touched up profile experiments
# This is the commit message #56:

More touchups to tag library (linking)
# This is the commit message #57:

More adjustments to copy
# This is the commit message #58:

More adjustments
# This is the commit message #59:

Correcting display bug failing to render chars in CSS
# This is the commit message #60:

Added a PDF with the notes.

# This is the commit message #2:

Decided to risk it
# This is the commit message #3:

One more readme
david-waltermire added a commit that referenced this issue Apr 13, 2018
@david-waltermire
# This is a combination of 7 commits.
05a5fff 
# The first commit's message is:

# This is a combination of 4 commits.
# The first commit's message is:

# This is a combination of 60 commits.
# The first commit's message is:

# This is a combination of 17 commits.
# The first commit's message is:

Restructuring for new initiative

Moved everything into 'old' and added a new subdirectory for new
experiments.

More early iteration over names

More adjustments in names mostly

HTML page for Word import testing

Just touchups this time

Updates and misc improvements

Changed document element to 'catalog'

Improved and renamed mapping transformation

Adjustments to models, schema, Schematron

Managing gitignore

Same

Minor adjustments

First cut at 27K mapping into OSCAL

Renamed directories for consistency

Cleanup

Bit more cleanup

Adjustments to mapping

Same

Numerous enhancements, some reorg

Planning notes

Added starter FO XSLT

First cut at FO XSL

Minor improvements

Small adjustments

Many/much schema enhancements; proto XSD version

First cut at inline declarations with live validation

Implementing declarations; styling

Refinements and extensions; new assign, select, withdrawn elements

More support for parameters etc.

Now implementing parameters etc.

More touches

Misc improvements

Sundry adjustments

Many more small improvements

Much documentation

More touchups

Updates

Misc adjustments and notes

Significant rework following design session esp declarations

More improvements incl extending declarations to groups

More adjustments; now mapping SP800-53A also.

More polishing and maintenance

Much more including hierarchical number checking

Adjustments, extensions, corrections

Name changes in the model

More adjustments

Cleanup of obsolete artifacts

Minor alignment

Mostly CSS, also Schematron improvements

ISO27002 mapping document

Many enhancements; new COBIT 5 mappings

More on COBIT

Improvements to mapping docs

Adjustments to mappings incl HTML versions

Moved screenshot for documentation

More adjustments and docs

Mostly improvements to documentation

Refreshed 800-53 data with adjustments

More general improvements to models and mappings

Continuing refinements to validations in samples

Update README.md

Update README.md

Update README.md

Update README.md

Minor tweaks

Including initial cut at profiling (1st, rule-based control extraction) among other refinements and improvements

No longer extant

Added new control to COBIT5 example

Misc improvements including more COBIT5 support

File rename and further adjustments

Misc adjustment; SaxonJS demo files

Misc adjustments

Updated readme contents to reflect merge.

Fixed links.

Changed text to better reflect current state and to add more links.

Rearrangement and cleanup

Schematron and schema adjustment and refactoring

SP800-53 extraction improvement, enhancement, cleanup

Improvements and enhancements to ISO27002 extraction

OSCAL Documentation

COBIT5 example tweakage

Organizational notes

Adjustments

Removed old files directory.
Moved files from draft to root.

Updated README.md to reflect new pathing.

Updated readme to contain more documentation of the OSCAL layers.

Added documentation for the working directory.

Update README.md

Edited the text.

Update README.md

Edited the text.

Added Aug 10 tiger team slides with notes

Create a prose overview of OSCAL

Update OSCAL Overview.md

Update OSCAL Overview.md

Profile and catalog mapping: a trivial example

Replacing graphic with rescaled version

Update OSCAL Overview.md

Rescaled image

Update OSCAL Overview.md

Mods to oXygen project file

Removing 'demo' (till later)

# This is the commit message #2:

Moved proprietary file

# This is the commit message #3:

Refinements to ISO27002 mappings (new model)

# This is the commit message #4:

Refining SP800-53 conversion/mappings

# This is the commit message #5:

Updating lib support for new model

# This is the commit message #6:

Top-level org

# This is the commit message #7:

Draft readme docs

# This is the commit message #8:

Further adjustment to directory readme.md

# This is the commit message #9:

More adjustments to ISO 27002 and SP800-53 (new model etc.)

# This is the commit message #10:

More cleanup to main sample subdirectories + readme tweakage

# This is the commit message #11:

Mostly restructuring

# This is the commit message #12:

More adjustments to extraction, parameter support

# This is the commit message #13:

Includes more model refinements; draft implementation of parameter resolution

# This is the commit message #14:

Adjustments for revised models

# This is the commit message #15:

Adjustments to demos and conversion pipelines

# This is the commit message #16:

Experimenting with profiles

# This is the commit message #17:

Infrastructure adjustments

# This is the commit message #2:

Minor correction to schema docs merge
# This is the commit message #3:

Updating XSD w/ docs
# This is the commit message #4:

More element renaming/adjustment
# This is the commit message #5:

Now a stable schema again? With SP800-53 extraction adjustments
# This is the commit message #6:

Profile-related mods

# This is the commit message #7:

Org stuff

# This is the commit message #8:

Moved mappind docs; added readme
# This is the commit message #9:

schema documentation
# This is the commit message #10:

Schema production and documentation pipeline
# This is the commit message #11:

More reorg; tweaked schema; more docs
# This is the commit message #12:

Improvements to tag library
# This is the commit message #13:

Another attempt at internal links in md
# This is the commit message #14:

trying again
# This is the commit message #15:

Gonna get this eventually
# This is the commit message #16:

More updates and tuneups
# This is the commit message #17:

More updates to schema and docs
# This is the commit message #18:

Lighter adjustments
# This is the commit message #19:

Similarly subtle adjustments
# This is the commit message #20:

Adjustments supporting parameter assignments
# This is the commit message #21:

More docs
# This is the commit message #22:

Enhancements to demo
# This is the commit message #23:

Moving distractions out of the way
# This is the commit message #24:

Slight readme tweakage
# This is the commit message #25:

Tag library tweaks
# This is the commit message #26:

More tag library adjustments
# This is the commit message #27:

New readme for Schematrons
# This is the commit message #28:

Adjustments to readme
# This is the commit message #29:

Adjustments to mapping documents
# This is the commit message #30:

Adjustments to readme
# This is the commit message #31:

More adjustments to mapping documents
# This is the commit message #32:

Updated punchlist
# This is the commit message #33:

Updates to mapping docs
# This is the commit message #34:

# This is the commit message #35:

CSS for local editing of OSCAL OSCAL
# This is the commit message #36:

Slight adjustments
# This is the commit message #37:

Light editing
# This is the commit message #38:

Light editing
# This is the commit message #39:

Light edits
# This is the commit message #40:

Light edits
# This is the commit message #41:

Light edits
# This is the commit message #42:

Light edits
# This is the commit message #43:

More work on profiles
# This is the commit message #44:

Revised directory descriptions
# This is the commit message #45:

Added an explanation of the demo directories
# This is the commit message #46:

More on profiling
# This is the commit message #47:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #48:

Editorial tweaks to oscal-oscal.xml
# This is the commit message #49:

Edits to schema documentation
# This is the commit message #50:

More enhancements to tag library and its presentation
# This is the commit message #51:

Internal links?
# This is the commit message #52:

Slight adjustments
# This is the commit message #53:

Further touchups to schema docs and their HTML rendering
# This is the commit message #54:

Support for 'pre'
# This is the commit message #55:

Rearranged and touched up profile experiments
# This is the commit message #56:

More touchups to tag library (linking)
# This is the commit message #57:

More adjustments to copy
# This is the commit message #58:

More adjustments
# This is the commit message #59:

Correcting display bug failing to render chars in CSS
# This is the commit message #60:

Added a PDF with the notes.

# This is the commit message #2:

Decided to risk it
# This is the commit message #3:

One more readme
# This is the commit message #4:

Added timestamping to extractors

# This is the commit message #2:

Light edits to oscal-oscal.xml
# This is the commit message #3:

More edits to oscal-oscal.xml with regenerated materials
# This is the commit message #4:

Refining markdown export
# This is the commit message #5:

More edits to docs and rendering
# This is the commit message #6:

This time smaller adjustments
# This is the commit message #7:

More improvements to docs and rendering
david-waltermire added a commit that referenced this issue Apr 13, 2018
@david-waltermire
Restructuring for new initiative
4aa8904 
Moved everything into 'old' and added a new subdirectory for new
experiments.

More early iteration over names

More adjustments in names mostly

HTML page for Word import testing

Just touchups this time

Updates and misc improvements

Changed document element to 'catalog'

Improved and renamed mapping transformation

Adjustments to models, schema, Schematron

Managing gitignore

Same

Minor adjustments

First cut at 27K mapping into OSCAL

Renamed directories for consistency

Cleanup

Bit more cleanup

Adjustments to mapping

Same

Numerous enhancements, some reorg

Planning notes

Added starter FO XSLT

First cut at FO XSL

Minor improvements

Small adjustments

Many/much schema enhancements; proto XSD version

First cut at inline declarations with live validation

Implementing declarations; styling

Refinements and extensions; new assign, select, withdrawn elements

More support for parameters etc.

Now implementing parameters etc.

More touches

Misc improvements

Sundry adjustments

Many more small improvements

Much documentation

More touchups

Updates

Misc adjustments and notes

Significant rework following design session esp declarations

More improvements incl extending declarations to groups

More adjustments; now mapping SP800-53A also.

More polishing and maintenance

Much more including hierarchical number checking

Adjustments, extensions, corrections

Name changes in the model

More adjustments

Cleanup of obsolete artifacts

Minor alignment

Mostly CSS, also Schematron improvements

ISO27002 mapping document

Many enhancements; new COBIT 5 mappings

More on COBIT

Improvements to mapping docs

Adjustments to mappings incl HTML versions

Moved screenshot for documentation

More adjustments and docs

Mostly improvements to documentation

Refreshed 800-53 data with adjustments

More general improvements to models and mappings

Continuing refinements to validations in samples

Update README.md

Update README.md

Update README.md

Update README.md

Minor tweaks

Including initial cut at profiling (1st, rule-based control extraction) among other refinements and improvements

No longer extant

Added new control to COBIT5 example

Misc improvements including more COBIT5 support

File rename and further adjustments

Misc adjustment; SaxonJS demo files

Misc adjustments

Updated readme contents to reflect merge.

Fixed links.

Changed text to better reflect current state and to add more links.

Rearrangement and cleanup

Schematron and schema adjustment and refactoring

SP800-53 extraction improvement, enhancement, cleanup

Improvements and enhancements to ISO27002 extraction

OSCAL Documentation

COBIT5 example tweakage

Organizational notes

Adjustments

Removed old files directory.
Moved files from draft to root.

Updated README.md to reflect new pathing.

Updated readme to contain more documentation of the OSCAL layers.

Added documentation for the working directory.

Update README.md

Edited the text.

Update README.md

Edited the text.

Added Aug 10 tiger team slides with notes

Create a prose overview of OSCAL

Update OSCAL Overview.md

Update OSCAL Overview.md

Profile and catalog mapping: a trivial example

Replacing graphic with rescaled version

Update OSCAL Overview.md

Rescaled image

Update OSCAL Overview.md

Mods to oXygen project file

Removing 'demo' (till later)

Moved proprietary file

Refinements to ISO27002 mappings (new model)

Refining SP800-53 conversion/mappings

Updating lib support for new model

Top-level org

Draft readme docs

Further adjustment to directory readme.md

More adjustments to ISO 27002 and SP800-53 (new model etc.)

More cleanup to main sample subdirectories + readme tweakage

Mostly restructuring

More adjustments to extraction, parameter support

Includes more model refinements; draft implementation of parameter resolution

Adjustments for revised models

Adjustments to demos and conversion pipelines

Experimenting with profiles

Infrastructure adjustments

Minor correction to schema docs merge

Updating XSD w/ docs

More element renaming/adjustment

Now a stable schema again? With SP800-53 extraction adjustments

Profile-related mods

Org stuff

Moved mappind docs; added readme

schema documentation

Schema production and documentation pipeline

More reorg; tweaked schema; more docs

Improvements to tag library

Another attempt at internal links in md

trying again

Gonna get this eventually

More updates and tuneups

More updates to schema and docs

Lighter adjustments

Similarly subtle adjustments

Adjustments supporting parameter assignments

More docs

Enhancements to demo

Moving distractions out of the way

Slight readme tweakage

Tag library tweaks

More tag library adjustments

New readme for Schematrons

Adjustments to readme

Adjustments to mapping documents

Adjustments to readme

More adjustments to mapping documents

Updated punchlist

Updates to mapping docs

CSS for local editing of OSCAL OSCAL

Slight adjustments

Light editing

Light editing

Light edits

Light edits

Light edits

Light edits

More work on profiles

Revised directory descriptions

Added an explanation of the demo directories

More on profiling

Editorial tweaks to oscal-oscal.xml

Editorial tweaks to oscal-oscal.xml

Edits to schema documentation

More enhancements to tag library and its presentation

Internal links?

Slight adjustments

Further touchups to schema docs and their HTML rendering

Support for 'pre'

Rearranged and touched up profile experiments

More touchups to tag library (linking)

More adjustments to copy

More adjustments

Correcting display bug failing to render chars in CSS

Added a PDF with the notes.

Decided to risk it

One more readme

Added timestamping to extractors

Light edits to oscal-oscal.xml

More edits to oscal-oscal.xml with regenerated materials

Refining markdown export

More edits to docs and rendering

This time smaller adjustments

More improvements to docs and rendering

Slight enhancement to schema mitigating whitespace issue in validation

Revert "Working"

Added comment template.

renamed file.

Cleaning up scraps (and checking setup)

Initial work modeling 'framework' for profiling functionality

More improvements supporting framework (profile) example

More adjustments to framework (profile) example

Touchups to framework strawman

Improvements to profiling (design and demo)

Updated OSCAL namespace

Fine adjustments for profiles especially regarding subcontrols

First efforts at FedRAMP mapping

More adjustments

More adjustments to profiling including SP80-53 baselines as profiles (provisional)

Slight improvement in logic just in case

Much development on profiling

More adjustments to profile examples and resolution including preventing infinite recursion in profile resolution

Superseded by profile resolver XSLT

FedRAMP misc

CSF stuff mainly

Touchups mostly

Adjustments in integration and display (CSF example mainly)

Rearranging schema docs

Cleanup

Misc improvements, touchups, reorg

Linking README.md to OSCAL Overview.md

Rename OSCAL Overview.md to OSCAL-Overview.md

Update README.md

Update README.md

Transferred/integrated content from main README.md

Moved content to docs/prose/OSCAL-Overview.md

Added pointer to tag library, resequenced material

Update README.md

Create Profile-Catalog-Relationship.md

Linked to the new Profile-Catalog-Relationship.md

Create Schema-Decisions

Rename Schema-Decisions to Schema-Decisions.md

Update README.md

Update README.md

Update OSCAL-Overview.md

More adjustments to schema docs (#25)

A couple of more or less misleading points now corrected

More updates

Moved documentation inside working, eliminating working/doc branch also adjustments to readmes

Amended and improved some high-level discussion

FedRAMP demo adjustments incl temporary readme

Fixed typo

Added presentation Dave made on 10.17.2017.

Correcting small bug in profile extraction

Many files rearranged also more dev on framework analysis

Touchups

New XSLT now runs assessment of a nominal 'worksheet' framework document producing a copy with links and annotations

Revs to high level docs and oscal-oscal.xml (issue #25)

Create README.md

Removed quotes

Mainly demo files for profiling implementation

Renaming in FedRAMP example to reduce confusion

More improvements and clarifications in demo

More adjustments incl filenames; new XSLT producing profile from linked worksheet

Schematron supporting worksheet editing

More adjustments to FedRAMP, schemas

More readme adjustments

More slight adjustments to schema setup

Added rev5 draft controls and moved rev4 to a new directory for better organization.

Added 800-53 schema version 2.0.

Wrapup on Sprint 4

Now UTF-8

Added feed container schema.

Tweaked to validate

Created schema directories for OSCAL XML and JSON schema.

Restructuring SP800-53 working dir

Updates to SP800-53 stuff for rev5

More refinements

Adjustments for SP800-53 rev5 OSCAL conversion

More Fedramp analysis including restructuring

Mini testing catalog

JSON under XSLT3 tinkering

Adjustments for capturing rev5

Fedramp mapping updates

Removing process litter

Schema and schema process updates

Now presenting profile demos

Rearranging schema files

Updated readme

Minor adjustments

Many improvements and adjustments including an implementation of patching in profiles

Improvements in resolution and rendering

Edits to samples and readmes

More unit tests

Another example

Schema adjustments; updated schema docs now describes profiling elements

Preliminary FedRAMP analysis

Standalone OSCAL SP800-53 rev4 and its baselines now in /examples

Refinements

SP800-53 updates

Improvements to profiling Schematron w/ mini-testing

Production pipeline adjustments

Ran fresh for some catalog adjustments

More detail on examples/mini-testing readme

Mini testing refresh

FEDRamp HIGHT baseline analysis with XSLTs

Refinements and reorganization to FedRAMP (preliminary) profile extraction

More refinements and polishing of FedRAMP examples

Further adjustments to profile examples

Further improvements to readme

Refresh

Adjustments in view of #64

Keeping profile schema in line w/ changes in core

Starting on hand adjustments to FedRAMP

Extending profiles Schematron to detect when profiles can/should use exclude instead of include

More updates and name changes

More minor adjustments (more of them and more minor)

Cleanup mostly

Improvements to tag library docs

Updating docs

Trying again (testing Github md alas)

More FedRAMP readme

More small edits

Touches

add json schema and examples

Signed-off-by: Andrew Weiss <anweiss@docker.com>

Update README.md

Update README.md

Update README.md

Update README.md

Added an issue template for our sprint-related issues.

Moved the issue template to the right location.

Added a number of issues templates to support project tracking and new
issue creation.

Initial cut and placeholder for Profile Semantics docs

Minor revs

More various edits

More adjustments

More revisions to profile semantics docs

Mostly more diagrams

More touchups to docs

More touchups to docs

Correction to top-level readme

Sketching implementation layer in XML

oXygen schema documentation

Touches

New page suggesting regrouping logic

Tweaking

More touchups and corrections

Had to rename the spec document

Now indexing to SP800-53 controls ... and params too, almost

Now correcting target type

New examples conforming to almost-ready new profile model

Updating terminology

More corrections

Towards new profile model

Merging now working

More adjustments to merge

Merge now includes provenance tracer

Updates to 'implementation layer' XML mockups

Updated examples to new profile schema

Updating HTML production pipeline

Updating tools, Schematrons

Rearranging to collapse paranoid temp directory

Correction to recursive import logic

Adjustments and updates

More corrections and improvements to profile/resolution/validation

Finishing modify implementation under new design

Updates to Merge-Diagrams.html

Adjustments to profiling spec docs

Refinements of enhancing "implementation" XML including RNC schema

Docs; cleanup

SVGs for all mini-testing examples (testing batch production)

Updated working/FedRAMP with some refinements

More misc

Create CONTRIBUTING.md

Create USERS.md

Minor adjustments prior to more major adjustments

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Next-next gen profile resolver, who default results are much simpler --

More adjustments to profile semantics

Added a link to the current active project

Add files via upload

Initial cut and placeholder for Profile Semantics docs

Minor revs

More various edits

More adjustments

More revisions to profile semantics docs

Mostly more diagrams

More touchups to docs

More touchups to docs

Correction to top-level readme

Sketching implementation layer in XML

oXygen schema documentation

Touches

New page suggesting regrouping logic

Tweaking

More touchups and corrections

Had to rename the spec document

New examples conforming to almost-ready new profile model

Updating terminology

More corrections

Towards new profile model

Merging now working

More adjustments to merge

Merge now includes provenance tracer

Updated examples to new profile schema

Updating HTML production pipeline

Updating tools, Schematrons

Fixed examples.

Adjustments and updates

Updates to Merge-Diagrams.html

Adjustments to profiling spec docs

Refinements of enhancing "implementation" XML including RNC schema

Updated working/FedRAMP with some refinements

More misc

Minor adjustments prior to more major adjustments

Aligning sprint-6

Initial cut and placeholder for Profile Semantics docs

Minor revs

More various edits

More adjustments

More revisions to profile semantics docs

Mostly more diagrams

More touchups to docs

More touchups to docs

Correction to top-level readme

Sketching implementation layer in XML

oXygen schema documentation

Touches

New page suggesting regrouping logic

Tweaking

More touchups and corrections

Now indexing to SP800-53 controls ... and params too, almost

Now correcting target type

New examples conforming to almost-ready new profile model

Updating terminology

More corrections

Towards new profile model

Merging now working

More adjustments to merge

Merge now includes provenance tracer

Updates to 'implementation layer' XML mockups

Updated examples to new profile schema

Updating HTML production pipeline

Updating tools, Schematrons

Rearranging to collapse paranoid temp directory

Correction to recursive import logic

Adjustments and updates

More corrections and improvements to profile/resolution/validation

Finishing modify implementation under new design

Updates to Merge-Diagrams.html

Adjustments to profiling spec docs

Refinements of enhancing "implementation" XML including RNC schema

Docs; cleanup

SVGs for all mini-testing examples (testing batch production)

Updated working/FedRAMP with some refinements

More misc

Create CONTRIBUTING.md

Create USERS.md

Minor adjustments prior to more major adjustments

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Putting up obfuscated and unobfuscated ISO 27002

Next-next gen profile resolver, who default results are much simpler --

More adjustments to profile semantics

Aligning sprint-6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@wendellpiez wendellpiez

@david-waltermire david-waltermire

@kscarfone kscarfone

Labels
LoE: Medium User Story
Projects
None yet
Milestone
OSCAL 1.0 Milestone 1
Development

No branches or pull requests
4 participants
@wendellpiez @david-waltermire @kscarfone @akarmel