OASIS OpenC2 TC: GitHub repository used to propose and track changes to the OpenC2 Language Specification as new working draft level revisions are created and the associated CSDs mature
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
images
latest add bullets to extension call-out Oct 17, 2018
previous
CONTRIBUTING.md
LICENSE.md
README.md

README.md

README

Members of the OASIS Open Command and Control (OpenC2) TC create and manage technical content in this TC GitHub repository ( https://github.com/oasis-tcs/openc2-oc2ls ) as part of the TC's chartered work (i.e., the program of work and deliverables described in its charter).

OASIS TC GitHub repositories, as described in GitHub Repositories for OASIS TC Members' Chartered Work, are governed by the OASIS TC Process, IPR Policy, and other policies, similar to TC Wikis, TC JIRA issues tracking instances, TC SVN/Subversion repositories, etc. While they make use of public GitHub repositories, these TC GitHub repositories are distinct from OASIS TC Open Repositories, which are used for development of open source licensed content.

Description

Purpose statement: Open Command and Control (OpenC2) is a concise and extensible language to enable the command and control of cyber defense components, subsystems and/or systems in a manner that is agnostic of the underlying products, technologies, transport mechanisms, or other aspects of the implementation. The OpenC2 Language Specification defines the OpenC2 language, and the responsibility for drafting it resides with the OASIS OpenC2 Language Subcommittee (LSC).

At the time of the creation of this GitHub repository, the OpenC2 Language Specification was at CSD (Revision) 01. The intent of this repository is to propose and track incremental changes to the CSD as it matures through several revisions. The intent is to use GitHub to track issues (e.g., issues brought by members when reviewing drafts and voting on CSD) and to use individual GitHub commits for change management of proposed changes to the CSD.

GitHub can be used to review individual commits (e.g., changes in response to an issue or new text added as it's agreed to by the LSC) and then the commits can be incorporated. Tools exist to support the creation of PDF/HTML/Word documents from the GitHub markdown text in the repository. Editable format Work Product documents in this repository are expected to adhere to the formal specification of "markdown" in the CommonMark standard. Markdown has human readable raw text that is simpler and cleaner than HTML or the underlying XML in Word or Google Docs. It also has the advantage of creating simpler, cleaner HTML than Google Docs or Word.

The goals of the repository include:

  • easier for members to review the changes to the CSD as it matures
  • easier for the editors to create the PDF/HTML/Word versions for official voting
  • "cleaner" raw text and HTML

Note: The OpenC2 Language Subcommittee Co-Chairs (Duncan Sparrell and Jason Romano) proposed this GitHub repository as a trial for the language CSD after some experience with the OpenC2 glossary and some experimentation of their own.

Contributions

As stated in this repository's CONTRIBUTING file, contributors to this repository are expected to be Members of the OASIS OpenC2 TC, for any substantive change requests. Anyone wishing to contribute to this GitHub project and participate in the TC's technical activity is invited to join as an OASIS TC Member. Public feedback is also accepted, subject to the terms of the OASIS Feedback License.

Licensing

Please see the LICENSE file for description of the license terms and OASIS policies applicable to the TC's work in this GitHub project. Content in this repository is intended to be part of the OpenC2 TC's permanent record of activity, visible and freely available for all to use, subject to applicable OASIS policies, as presented in the repository LICENSE file.

Further Description of this Repository

The process for proposing/reviewing/accepting changes to the OpenC2 Language Specification using github is a work in progress and will be described at https://wiki.oasis-open.org/openc2/LanguageMarkDownProcess until we've got it worked out well enough to include right here in the readme.

Contact

Please send questions or comments about OASIS TC GitHub repositories to Robin Cover and Chet Ensign. For questions about content in this repository, please contact the TC Chair or Co-Chairs as listed on the the OpenC2 TC's home page.