GitHub Repositories for OASIS TC Members' Chartered Work

OASIS TCs that wish to develop content using dedicated version control system support may request the creation of a Subversion (SVN) repository and/or GitHub public repositories. Whereas SVN repositories are allocated on a one-per-TC basis, multiple GitHub repositories may be requested by any TC for distinct development projects. Each GitHub repository will be configured using the default setup to support issues tracking, project boards, and a Wiki instance.

Governance. A GitHub repository for OASIS TC Members' chartered work is governed by the same OASIS policies as govern a TC Wiki, a TC Subversion repository, a TC JIRA Issues Tracker, a TC Kavi document repository, etc. Unlike the OASIS Open Repositories — which also make use of GitHub public repositories for development of open source licensed assets — GitHub repositories for OASIS TCs follow rules in the OASIS TC Process, OASIS IPR Policy, and related policies.

Repository Request. When any TC has decided to create a new GitHub repository, a TC officer (Chair or Secretary) may request a public GitHub repository using the online request form.

Maintainers. When a TC makes request for creation of a GitHub repository, one or more TC Members must be designated to serve as initial Maintainer(s) — sometimes also called "Committer(s)". Additional or substitute Maintainers may be designated at any time from among qualified TC Members.

All TC members may "contribute" substantive content, as well as provide input via GitHub Issues, comments, GitHub conversations, Wiki edits (etc), but they do not have full Maintainer responsibilities, described below. A regular TC Member can be a "contributor" in the GitHub defined sense: "contributor is someone who has contributed to a project by having a pull request merged but does not have collaborator [ viz, direct write] access."

A Maintainer, much like a prose specification editor, holds the pen and has direct write access to the GitHub "code" repository. A Maintainer accepts input from all TC members, evaluating it for incorporation into revised content. TC member input is expected in the form of GitHub Issues/Comments, GitHub conversations, pull requests, but might also be taken from the TC discussion list, or from TC meetings.

A Maintainer thus serves in an editorial capacity by having responsibility for assigning and closing issues, creating and associating milestones, creating releases, designating a default branch, creating and applying labels, initiating conversations on pull requests, merging and closing pull requests, assigning evaluation of a pull request, resolving merge conflicts, etc. The Maintainers may also monitor repository activity to help ensure that substantive contributions are made only by TC Members or by parties who agree to the terms of the OASIS Feedback License, as explained in the repository's CONTRIBUTING file.

Initial Repository Content. At startup, each TC GitHub repository will include default files README, CONTRIBUTING, and LICENSE, provided as boilerplate by OASIS Staff. Maintainers should ensure that content in the CONTRIBUTING and LICENSE files remains unaltered; content in the README file may be adapted to reflect the TC's project goals (viz., in sections and subsections following "Further Description of this Repository").

Substantive Contributions and Public Feedback. Contributors to a TC GitHub Repository are expected to be Members of the associated OASIS Technical Committee, for any substantive contributions. Anyone wishing to actively participate in the TC's technical activity is invited to join as a TC Member. Public feedback on repository content is also accepted: persons who are not TC members are invited to open issues and provide comments using a TC Repository's GitHub Issues tracking facility or using the TC's comment list. All such content created in GitHub Issues and/or posted to the TC's archived comment list is governed by the terms of the OASIS Feedback License.

Feedback or questions. Send email to Robin Cover and Chet Ensign.