CONTRIBUTING.md

Contributing to geni-portal

The GENI-NSF repositories are very much a community driven effort, and your contributions are critical. A big thank you to all our contributors!

Mailing Lists

• GENI experimenters can ask questions and get announcements on the GENI Users Google group.
• Developers can discuss GENI development on the GENI Developers Google group.

General Guidelines

• GENI-NSF projects follow the GitHub open source project guidelines.
• Create a GitHub Issue for any bug, feature, or enhancement you find or intend to address.
• Submit enhancements or bug fixes using pull requests (see the sample workflow below).
• GENI-NSF projects use the GitHub Flow branching model.
• All GENI-NSF code is released under the GENI Public License and should include that license.

Reporting Issues

• Check existing issues first to see if the issue has already been reported.
• Review the general GitHub guidlines on isssues.
• Give specific examples, sample outputs, etc
• Do not include any passwords, private keys, your omni.bundle, or any information you don't want public.
• When reporting issues, please include screen shots (simply drag them in), a description of what you did, any request RSpec, etc.
• To attach your test case RSpecs or other large output, upload the file to some web server and provide a pointer. For example, to use Gist:
• Copy & paste your log/patch/file attachment to http://gist.github.com/, hit the Create Public button and link to it from your issue by copying & pasting its URL.

Getting the Source

GENI Portal source code is available on GitHub.

Sample Contribution Workflow

1. Report the issue or check issue comments for a suggested solution.
2. Create an issue-specific branch off of the master branch in your fork of the repository.
3. Develop your fix.

• Follow the code guidelines below.
• Reference the appropriate issue numbers in your commit messages.
• Include the GENI Public License and a copyright notice in any new source files.
• All changes should be listed in the CHANGES file, with an issue number.

4. Test your fix
5. Pull in any new changes from the main repository ('upstream' repository).
6. Submit a pull request against the master branch of the project repository.

• In your pull request description, note what issue(s) your pull request addresses.

Code Style

• Include the GENI Public License as a comment at the top of all source files.
• Document all files and key classes and methods.
• Name classes, methods, arguments and variables to describe their use.

Thank you for your contributions!