search

opencontrol / discuss

a place to have conversations about OpenControl projects
https://github.com/opencontrol/discuss/issues
Other
16 stars 0 forks source link

Output rendering #24

Open anweiss opened 7 years ago

anweiss commented 7 years ago

It would be great to come up with a consensus on where OpenControl fits in to the actual generation of documentation. There have been some discussions on Slack in regards to removing the actual SSP documentation generation functionality from compliance-masonry, and instead use it solely for validation, gap analysis and converting yaml to various meta-formatted text (e.g. markdown and ReStructuredText which can be fed in to MkDocs, Jekyll, Readthedocs, etc). Do folks agree on this approach?

yruss972 commented 3 years ago

Definitely interested in more flexible documentation rendering. Ambiguous about upgrading the functionality inside masonry or developing something new but I don't see meta-formatted text as the right vehicle. It would be better IMO to support one of many off the shelf templating engines. The output would be much more flexible and customization much more approachable IMO.