Changeset 663 for branches/PublicaMundi_David-devel/docs/contribute

Timestamp:

Jun 16, 2015, 11:59:50 AM (9 years ago)

Author:

nbozon

Message:

various enhancements and missing doc files

Location:

branches/PublicaMundi_David-devel/docs/contribute

Files:

• code.rst (modified) (1 diff)
• doc.rst (added)
• howto.rst (modified) (2 diffs)
• index.rst (modified) (1 diff)

branches/PublicaMundi_David-devel/docs/contribute/code.rst

@@ +1 @@
+.. _contribute_code:
+
 Contribute code
 ===============
 
-Anybody is welcome to share and contribute ideas, code, documentation or any relevant resource
-using the following media.
+Anybody is welcome to share source code and to report bugs or feature requests using the following instructions.
 
 Submit new code
 --------------------------
 
+For new comers
+*************************
 
-Report a code issue
+New source code or existing source code corrections (patches) should be submitted using the ZOO-Project bug tracking system (ZOO-Trac).
+
+Create a new ticket in order to describe your code or patch and attach it to the ticket (attach all the needed files needed to use your code or patch). It will then be checked and discussed with the developers, and can potentially be merged with the trunk.
+
+For registered developers
+***************************
+
+ZOO-Project registered developers have direct svn access and can:
+
+* Commit fixes, enhancement and new source directly to trunk
+  
+* Create and commit to a new branch of the svn
+
+Bug tracking
 --------------------------
 
+General information
+*********************
 
+Bug reports and wishes can be submitted using the ZOO-Trac. This requires you to setup a user account (userid) using this section.
+
+The following trackers are available:
+
+* *defects* to report bugs and 'bad' features
+* *enhancement* to describe feature wishes
+* *task* to describe any different but relevant topic.
+
+The following components are available:
+
+* *Developemnt platform* to report bugs and 'bad' features
+* *ZOO-Kernel* to report a bug or problem with the ZOO-Project WPS server
+* *ZOO-Services* to report a bug or problem with the ZOO-Project WPS services
+* *ZOO-API* to report a bug or problem with the ZOO-Project API
+* *ZOO-Client* to report a bug or problem with the ZOO-Project Client
+* *Documentation* to report a problem or suggest an enhancement to the documentation
+  
+Best practices
+*********************
+
+Please consider the following when submitting bugs or feature requests:
+
+* Check if the bug is still persistent in svn trunk before reporting. If you use an older version, please consider upgrading.
+* Before reporting a bug, please search if it is yet unknown in the bug tracking system.
+* Give an appropriate, starightforward and understandable title to your ticket using the *Summary* field   
+* Make sure the developers get all the needed information to recreate the bug using the *Description* field (e.g. tell about your configuration and explain every step to reproduce the bug).
+* Select at least a *Type* of tracker and a *Component* for your new ticket.
+* Report only one single bug by ticket.
+
+

branches/PublicaMundi_David-devel/docs/contribute/howto.rst

@@ -2 +2 @@
 ==================
 
-Please consider the following simple rules if you would like to
-contribute to `ZOO-Project <http://zoo-project.org>`__ .
-
+Please consider the following simple rules if you would like to contribute to  the `ZOO-Project <http://zoo-project.org>`__  open source software.
 
 Community 
 -------------------
 
-Anybody is welcome to share and contribute ideas, code, documentation
-or any relevant resource. This should be done according to the directives stated in the ZOO-Project :ref:`contribute_index`.
+Anybody is welcome to share and contribute ideas, code, documentation or any relevant resource. This should be done according to the directives stated in the ZOO-Project :ref:`contribute_index`.
+
+Governance
+......................................
+
+`ZOO-Project <http://zoo-project.org>`__ activities are directed by the Project Steering Committee (PSC) and the software itself is being developed, maintained and documented by an international community of users and developers (aka `ZOO-Tribe <http://zoo-project.org/new/ZOO-Project/ZOO%20Tribe>`_).
+
+Contributions are moderated and integrated in trunk at the discretion of the `ZOO-Project <http://zoo-project.org>`__ PSC. Commit access are usually granted to active contributors by vote from the PSC members. 
 
 Licensing
 ......................................
 
-`ZOO-Project <http://zoo-project.org>`__ source code is open source and
-made available under the `MIT/X-11
-<http://opensource.org/licenses/MITlicense>`__  `license
-<http://zoo-project.org/trac/browser/trunk/zoo-project/LICENSE>`__. You
-must agree to the terms of that same license when creating, submiting
-and releasing new source code.
+`ZOO-Project <http://zoo-project.org>`__ source code is open source and made available under the `MIT/X-11 <http://opensource.org/licenses/MITlicense>`__  `license
+<http://zoo-project.org/trac/browser/trunk/zoo-project/LICENSE>`__. You must agree to the terms of that same license when creating, submiting and releasing new source code.
 
-`ZOO-Project <http://zoo-project.org>`__ documentation is open source and
-made available under the `Creative Commons Attribution-ShareAlike 4.0 International Public License
-<https://creativecommons.org/licenses/by-sa/4.0/legalcode>`__ . You
-must agree to the terms of that same license when creating, submiting
-and releasing a new documentation file.
-
-
-Governance
-......................................
-
-
+`ZOO-Project <http://zoo-project.org>`__ documentation is open source and made available under the `Creative Commons Attribution-ShareAlike 4.0 International Public License
+<https://creativecommons.org/licenses/by-sa/4.0/legalcode>`__ . You must agree to the terms of that same license when creating, submiting and releasing a new documentation file.
 
 Available media
 -------------------
 
-Discussions and contributions are encouraged using the following media
+Discussions and contributions to `ZOO-Project <http://zoo-project.org>`__ are encouraged using the following public media.
 
 Mailing lists
 ......................................
 
-Post any feedback, comment or idea to the general public mailing
-list. For project managment or governance topics, use the PSC list.
+Feel free to post any question, feedback, comment or idea to the general public mailing list. For project managment or governance topics, please use the PSC list.
 
 ..   csv-table::
@@ -55 +45 @@
 ......................................
 
-Join #zoo-project channel on irc.freenode.net to discuss with the ZOO-Tribe
+Join the **#zoo-project** channel on irc.freenode.net to discuss with the ZOO-Tribe at any time.
 
 
-Tracker and wiki
+Tracker
 ......................................
 
-Contributions and bug reports should be shared using the `ZOO-Project
-<http://zoo-project.org>`__ bug tracking system, as specified in the
-:ref:`contribute-code` section. Wiki pages can also be created to
-describe contributions and or actions.
+Bug reports and code patches should be shared using the `ZOO-Project <http://zoo-project.org>`__ bug tracking system, as specified in the :ref:`contribute-code` section. 
+
+Wiki
+......................................
+
+Wiki pages can also be created by registered users. They can be used in order to describe any concept, contribution and or action that benefits or is related to the project.

branches/PublicaMundi_David-devel/docs/contribute/index.rst

@@ -15 +15 @@
    howto
    code
+   doc