Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Showing
1 changed file
with
15 additions
and
29 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 |
---|---|---|
@@ -1,66 +1,52 @@ | ||
|
||
------------------------------------------------------------ | ||
Contributing to Guacamole | ||
Contributing to Apache Guacamole | ||
------------------------------------------------------------ | ||
|
||
Thank you for contributing to the Guacamole project! | ||
Thank you for contributing to the Apache Guacamole project! | ||
|
||
There are certain procedures that must be followed for all contributions. These | ||
procedures are necessary to allow us to allocate resources for reviewing and | ||
testing your contribution, as well as to ensure we have your legal | ||
authorization to include your contribution in Guacamole. | ||
testing your contribution, as well as communicate effectively with you during | ||
the review process. | ||
|
||
1) Create an issue in our JIRA | ||
|
||
All changes to Guacamole must have corresponding issues in JIRA so the | ||
change can be properly tracked: | ||
|
||
http://glyptodon.org/jira/ | ||
https://issues.apache.org/jira/browse/GUACAMOLE/ | ||
|
||
If you do not already have an account on our JIRA, you will need to create | ||
one before creating your new issue. | ||
If you do not already have an account on the Apache Software Foundation's | ||
JIRA, you will need to create one before creating your new issue. | ||
|
||
2) Make and test your changes locally | ||
|
||
The Guacamole source is maintained in git repositories hosted on GitHub: | ||
|
||
https://github.com/glyptodon/guacamole-client | ||
https://github.com/glyptodon/guacamole-server | ||
https://github.com/apache/incubator-guacamole-client | ||
https://github.com/apache/incubator-guacamole-manual | ||
https://github.com/apache/incubator-guacamole-server | ||
https://github.com/apache/incubator-guacamole-website | ||
|
||
To make your changes, fork the applicable repositories and make commits | ||
to a topic branch in your fork. Commits should be made in logical units | ||
and must reference the JIRA issue number: | ||
|
||
$ git commit -m "GUAC-123: Message describing the specific changes made." | ||
$ git commit -m "GUACAMOLE-123: High-level message describing the changes." | ||
|
||
Avoid commits which cover multiple, distinct goals that could (and should) | ||
be handled separately. | ||
|
||
If you do not already have an account on GitHub, you will need to create | ||
one before making your changes. | ||
|
||
3) Sign our Contributor License Agreement (CLA) | ||
|
||
All contributors to the Guacamole project must have signed CLAs on file | ||
before we can merge their contributions: | ||
|
||
http://glyptodon.org/cla.html | ||
|
||
This is necessary to ensure we have the legal right to include your code | ||
in our repositories, that we can continue to distribute that code under | ||
the MIT license, and that you have the legal right to give us that code. | ||
|
||
If you create a pull request without first signing the CLA, you will be | ||
asked to do so before the pull request is reviewed. | ||
|
||
4) Submit your changes via a pull request on GitHub | ||
3) Submit your changes via a pull request on GitHub | ||
|
||
Once your changes are ready, submit them by creating a pull request for | ||
the corresponding topic branch you created when you began working on your | ||
changes. | ||
|
||
The Guacamole team will then review your changes and, if they pass review | ||
and we have your CLA on file, your changes will be allocated to a sprint | ||
for final testing and merge, and your name will be added to the list of | ||
contributors for whichever repositories contain your contributions. | ||
The Guacamole team will then review your changes and, if they pass review, | ||
your changes will be merged. | ||
|