Document OSCAL Markdown

[wendellpiez]

User Story:

As an OSCAL User building interfaces, I may need to know how OSCAL's flavor of Markdown works and what it permits.

Goals:

1. Update documentation for prose on pages.nist.gov.
   • Document use of OSCAL markdown syntax.
   • Show examples of prose in HTML and markdown based on OSCAL subsets
   • Create a table showing the HTML <> Markdown correspondences

Dependencies:

#343 must be finished so we have confidence that OSCAL Markdown works as currently designed.
#452 needs to be completed to ensure that the prose documentation page is in sync with the actual content generation behavior.
#451 needs to be fixed to ensure parameter insertion is handled as expected.

Acceptance Criteria

Users can find some help on using OSCAL Markdown on the Pages site.

[iMichaela]

5/23/2019

#283 is nearly done so we can start working on this issue.

[david-waltermire]

@wendellpiez It would be good to update the website prose page to include a mapping between HTML and Markdown features that are supported. This can be bumped to sprint 22, as it is not a blocker for the M1 release.

[david-waltermire]

#452 needs to be completed before this is closed.

[david-waltermire]

#451 needs to be fixed to ensure parameter insertion is handled as expected before this is closed.

[david-waltermire]

This documentation is currently located in my branch. We can merge PR #449 once this is reviewed by the team and issues #451 and #452 are completed and verified.

[david-waltermire]

This has been completed in PR #449.