...
The team keeps in touch on a day-to-day basis via the development list and Skype. We generally try to keep significant discussions on the list, but prefer Skype for higher-bandwidth discussions.
We also have bi- weekly, virtual Committer Meetings where we discuss our recent work on the FCRepo project. This also gives us a way to share what we're doing with interested members of the community (the meeting minutes are public). Generally, committers employed by Fedora Commons are present at these meetings, and committers from other organizations may attend as their time allows.
...
- Code Style
The project's coding style is currently best described by the Eclipse settings in src/build. Here are the major rules:- Four space indents for Java, and 2-space indents for XML. NO TABS.
- K&R style braces:
Code Block if (code) { // code } else { // code } - Dont use wildcard imports
- Write Javadocs for public methods and classes. Keep it short and to the point.
- Avoid public instance variables; use accessors.
- Use public methods sparingly; implementation details are not public.
- Logging
We currently use Log4J SLF4J for logging. This may change in the future, but until it does, please be consistent. When writing log messages (especially INFO, FATAL, and WARN), consider your audience. Don't over-use INFO; these messages are always logged by default. - Testing
Use JUnit for unit, integration, and system tests. When making changes, please take the time to write tests as needed. We are not looking for 100% coverage here, but the developers will have a lot more confidence in your code if you can show that it works. See the readme.txt in the root of the source tree as a jumping-off point for adding your tests to one of the suites. Here's a brief description of the basic types of tests we run:- Unit - Tests a single class. These tests are typically very quick to run, and therefore get the most use by developers. Unit tests don't touch the disk or interface with classes other than mocks. If you can cover a scenario adequately in a unit test, you should prefer implementing it as such (and not as an integration or system test)
- Integration - Tests multiple classes working together. May touch disk or interact with a "test" database.
- System - Works against a running Fedora server in a given configuration. These are "block box" style tests against the public APIs of Fedora. These take much longer to run than unit or integration tests because they require significant setup.
...