Established at the Vancouver Moby-Dic Developers Meeting May 7, 2005. Ben Good suggested to call itThe Twelve Commandments
If you work on the code that does not compile yet, and if you, from some reasons, need to commit such code, then create a directory (or more directories) named notyet (anywhere under src/main directory). These are by default excluded from the compilation - so the sources in these directories do not break this commandment.
Remember that until we use Subversion instead of CVS the directories are hard to remove once they are created. Document the contents of new packages in the package descriptions.
In other words, jMoby is not a place for every BioMoby service written in Java. Such services are and will be spread around the world. Put into jMoby rather services that have a tutorial/didactic value.
It is not enough just to add a new jar file in your lib sub-directory (because other developers will not have it). It is not recommended to add a new jar file into CVS - if you have a new jar file, change instead the build.xml file (actually change the xmls/libraries that is used by build.xml).
All third parties come to your CVS local copy when you execute ant install (from various Maven repositories).
Make also sure that javadoc will not create any warnings. A good practice is also to include a brief summary of your changes in the docs/ChangeLog file (if using Emacs try 'Ctrl-x 4 a' to add a new entry). Last but not least, at least for bigger code groups: create an HTML document describing how to use your code and link it from index.html.