Contributing to MV3D
MV3D is a very ambitious project, and it needs your help! First thing you'll want to do is to register for an account on the forums and wiki. You should then probably email mike at mv3d dot com to get your accounts activated (darn spammers). MV3D is developed with Scrum. Development is broken up into sprints (milestones in trac), and each sprint, tickets to be worked on are pulled from the backlog. All work to be done (bugs and features) have associated tickets. Basically, MV3D follows UQDS. In short, a ticket is created, it's assigned to a milestone. A branch is created for all work done in that ticket and someone starts working on it. When ready, they submit the ticket for review and the reviewer checks over the changes and either approves it or hands it back with suggestions. If you don't have svn write access, then the process is similar, but just attach a patch to the ticket when submitting for review. MV3D uses Divmod's coding standard for all code.
If you're looking for something to do, here's a list of tickets that are marked as easy:
- #292
- Incoming chat messages should make a sound.
- #391
- Split up mv3d.test.test_net
- #392
- More tests for mv3d.test.test_securable
- #395
- More tests for mv3d.phys.collider
- #415
- More tests and docstrings for mv3d.util.container
- #417
- New docstrings for mv3d.util.math3d
- #422
- Standardize the config file
- #432
- Fix the camera
- #446
- Errors during startup of a single service shouldn't affect other services
Ticket Conventions
In addition to the standard trac workflow, we also use keywords to denote a secondary status for tickets. Use the 'review' keyword to specify that a ticket is ready for review. The 'stealable' keyword should be used on tickets that are up for grabs for anyone to take on.
