Contributing

How to Contribute

Perhaps the easiest way to contribute is to download and install the code, join the implementors mailing list and share your experiences (good or bad) using the portal and share your ideas as to how it can be improved. You can also visit the Jasig wiki and contribute your ideas there.

At the next level, you can contribute code in the form of bug fix solutions, enhancements, uPortal channel or portlets. If you wish to contribute to the uPortal Framework itself, you should first subscribe to the uPortal Framework Developers mailing list as outlined above and discuss your contributions with the other developers.

Contributing Documentation

The uPortal project also needs contributions in the area of documentation. You can help. Our wiki is now the primary mechanism for documenting uPortal.

If you are interested in contributing a significant amount of documentation or code snippets please submit the necessary licensing agreements (see below).

Submitting documentation is an easy process:

  1. Send an email through the uportal-user mailing list with "Documentation" in the subject line
  2. The documentation coordinator will work with you to get your contribution in the manual.

Documentation Style Guide is available to help you write your documentation contribution.

Contributor Agreements

As a community organization supporting open source software development, Apereo uses a set of licenses, agreements, and policies to manage its software projects and the intellectual property surrounding them. These help us to provide proper governance and sustainability to these projects.

Individuals must have an Individual Contributor License Agreement  (ICLA) on file with Apereo before any significant contributions will be accepted and before commit privileges will be granted on Apereo projects.  An ICLA is required before a proposed Pull Request can be merged.

Organizations that have tasked employees to work on a Jasig project should also complete a Corporate Contributor License Agreement (CCLA) so intellectual property that may have been assigned as part of an employment agreement can still be properly contributed. Individuals still must submit an ICLA, even when their organizations has completed a CCLA.

 

Additional References

Having problems with these instructions?

Please send us feedback at uportal-user@lists.ja-sig.org