Browse files

Added information for contributors

* Feature: added information for contributors
[ciobabog refs #13892]
  • Loading branch information...
1 parent e7a9015 commit 533ada1b8e95c5a3662a3b5a37bd09ceaa31dd7c @sboghy sboghy committed Mar 5, 2013
Showing with 57 additions and 0 deletions.
  1. +55 −0
  2. +2 −0 docs/HISTORY.txt
@@ -0,0 +1,55 @@
+# How to contribute
+To start, is important to mention that we keep all EEA pacakges under EEA Organisation
+on GitHub ( and we fork them to Collective so everyone can
+contribute to them. We keep the repositories from Collective and EEA in sync.
+We want to keep it as easy as possible to contribute changes that
+get things working. There are a few guidelines that we
+need contributors to follow so that we can have a chance of keeping on
+top of things.
+## Getting Started
+* Make sure you have a [GitHub account](
+* If you need to submit a ticket do it under EEA Organisation area (
+ under the respective package, e.g.
+* Submit a ticket for your issue, assuming one does not already exist.
+ * Check that issue/feature is not already reported under EEA official issues register for Zope/Plone at
+ * Clearly describe the issue including steps to reproduce when it is a bug.
+ * If case state the browser and operating system used.
+* We also keep a discussion lists for most of the public packages under Google Groups.
+Please note that adding a bug report or feature request in the EEA github does not
+automatically mean that EEA will work on them, since there are budget implications.
+The issues/features registered in github are regarded only as community requests and
+here to facilitate the Plone community contributions.
+EEA will work directly on the Plone community's requests when they coincide with
+EEA's planned projects. In this case we will transfer the ticket to the EEA
+official issue register.
+EEA sprints are managed at
+## Making Changes
+* The pull requests and changes must be done on packages found on Collective
+ e.g.
+* Fork the repository from Collective not from EEA (as stated above they
+ will be synced in automatic)
+* Make sure you added an entry under HISTORY.txt describing your changes
+* Make sure you have added the necessary tests for your changes (do not forget major browsers).
+* Make sure you have updated and added documentation when necessary.
+* Run _all_ the tests to assure nothing else was accidentally broken.
+## Submitting Changes
+* Push your changes in your fork of the repository.
+* Submit a pull request to the repository in the Collective organization.
+# Additional Resources
+* [General GitHub documentation](
+* [GitHub pull request documentation](
+* [EEA packages](
@@ -6,6 +6,8 @@ Changelog
5.5 - (2013-02-25)
+* Feature: added information for contributors
+ [ciobabog refs #13892]
* Change: Plone 4.3 compatible

0 comments on commit 533ada1

Please sign in to comment.