-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Create CONTRIBUTING.md * OpenAPI changed
- Loading branch information
1 parent
a37b660
commit 68e3cdb
Showing
2 changed files
with
171 additions
and
194 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
# CONTRIBUTING | ||
|
||
This schema is developed by the [Cloud Work Stream](https://ga4gh.cloud) of the [Global Alliance for Genomics and Health](https://ga4gh.org). | ||
|
||
## Semantic Versioning | ||
|
||
We use [semantic versioning](https://semver.org/) for TRS, this will determine if your proposed changes impact a major or minor release. | ||
|
||
## Suggesting Changes | ||
|
||
Suggested changes to this schema can be initiated as [**Issues**](https://github.com/ga4gh/tool-registry-service-schemas/issues) or [**Pull Requests**](https://github.com/ga4gh/workflow-execution-service-schemas/pulls) to allow for discussion and review. | ||
|
||
Even those with write access to the main repository should in general create pull request branches within their own forks. This way when the main repository is forked again, the new fork is created with a minimum of extraneous volatile branches. | ||
|
||
<!-- activate after https://github.com/ga4gh/tool-registry-service-schemas/issues/60 | ||
> To facilitate review of external pull requests, users are encouraged to activate [**Travis CI**](https://travis-ci.org/) to monitor the build status (documentation, Swagger UI) of their fork. By following the documentation for [deployment to GitHub Pages](https://docs.travis-ci.com/user/deployment/pages/) and adding a `$GITHUB_TOKEN` environment variable to their repo configuration, pushes to the forked repo should be viewable relative to `https://[user-or-org].github.io/workflow-execution-service-schemas/preview/<branch>/`: | ||
+ https://[user-or-org].github.io/workflow-execution-service-schemas/preview/\<branch\>/docs/ | ||
+ https://[user-or-org].github.io/workflow-execution-service-schemas/preview/\<branch\>/swagger-ui/ | ||
+ https://[user-or-org].github.io/workflow-execution-service-schemas/preview/\<branch\>/swagger.json | ||
+ https://[user-or-org].github.io/workflow-execution-service-schemas/preview/\<branch\>/swagger.yaml | ||
> Providing this base URL in the pull request comment is appreciated, but not required. | ||
If a security vulnerability is identified with the specification please send an email to security-notification@ga4gh.org detailing your concerns. | ||
## Approving Changes | ||
### pre-WES v1.0.0 / Testbed Voting Procedure | ||
Changes for the release are to be approved by four developers - Marcus Kinsella (HCA), Jeff Gentry (Broad Institute), James Eddy (Sage Bionetworks), Peter Amstutz (Veritas Genetics). In addition they must not be overridden by the Cloud Work Stream Leads, Brian O'Connor and David Glazer. | ||
### post WES v1.0.0 Voting Procedure | ||
GA4GH has a number of Driver Projects. Each of those associated with the Cloud Work Stream will nominate a representative. None of these may vote against a proposed change for it to proceed. In addition they must not be overridden by the Cloud Work Stream Leads, Brian O'Connor and David Glazer. | ||
--> |
Oops, something went wrong.