Wiki source for ContributingtowebERP


Show raw source

|=|{{image alt="webERP logo" title="webERP Logo" url="images/webERPlogo.gif"}}|=|[[HomePage What Is webERP]] |=| [[WeberpFeatures webERP Features]] |=|[[WeberpFaq Documentation]]||

|=|[[WeberpSupport Support]] |=|[[http://www.weberp.org/forum Forum]] |=|{{image class="center" alt="Sourceforge Logo" title="Sourceforge Logo" url="http://sflogo.sourceforge.net/sflogo.php?group_id=70949&type=9" link="http://sourceforge.net/projects/web-erp"}} |=| [[http://sourceforge.net/project/platformdownload.php?group_id=70949&sel_platform=3757 Download]] |=| [[http://www.weberp.org/weberp/index.php Demo]] |=|[[WeberpDevelopment Development]]||
----


=====Contributing to webERP=====

The guiding principles are driven by the ProjectGoals
All code contributions must comply with the CodingConventions

====Procedure For Contributing====
Contributions to the webERP project are encouraged - these simple procedures for doing so are aimed at reducing the confusion and co-ordinating the efforts of all contributors:

1.Join the developers mailing list.

http://lists.sourceforge.net/lists/listinfo/web-erp-developers

Inform the list of your proposed developments and discuss the approach to be used. There are some knowledgeable people on the list and they can contribute ideas if you let them. This is also good to avoid overlapping effort or combine efforts in working on different elements of the same project.
A few points to remember about the mailing list:
~- Polite and cordial exchanges with good humour get the best responses.
~- Please do not respond to an email if you are angry at what someone wrote. Email stays written long after you have calmed down and will embarrass you later.
~- Email can be a little impersonal and whilst the information published on the list is very public we do encourage the use of first names at least in list communications.
~- Commercial arrangements with other list members should be kept off list.
~- Advertising of services should be limited to web-site information at the end of emails.
~- A relevant demonstration of your technical knowledge that helps another user/developer or the project - is always appreciated.

2. Obtain the latest development scripts from SVN - see sourceforge instructions for anonymous SVN checkout the SVN files initially then updates daily - this only downloads any modified scripts, or update immediately before commencing any development.


''IMPORTANT: Only do development work on the most recent scripts from SVN and update your copy of the SVN regularly. Instructions on the use of SVN at sourceforge can be found at the following URL:''

http://sourceforge.net/projects/web-erp/develop

3. This point is relevant only for developers that do not have SVN write access. After any modifications to the scripts - email (only) the modified scripts (and ideally a diff file between the latest SVN scripts and your updated scripts) to submissions@weberp.org within 12 hours of your last update from SVN. The project admin will have to digest the modifications and ensure the coding style is consistent, test the scripts and consider the implications of the modifications in achieving the goals noted above. Plenty of narrative explaining the modifications should be posted in the developers list so all can consider the implications. They will be committed to SVN as soon as possible after receipt and testing.

4. Where modifications span 10 or more scripts at the same time, request a stay on development from other developers using the list.

5. All submissions of modifications or additions should be accompanied by a plain text change.log file describing the changes to each script. This explains to everyone the nature of the changes made. Each entry in the change log should state the developer name and date of the change/addition. This file will be appended to the doc/change.log when the files are committed to SVN.

6. Requests for modification of the database structure - with an extract of the SQL required to effect the changes should be made to submissions@weberp.org These will be included in the version upgrage script as well as the latest database structure.
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki