Developers

Where to Get Started

• The OpenMRS Development website - (Trac)
• Step-by-Step Installation for Developers
• OpenMRS Technical Overview
• Developer How-To Guide
• WorkingGroups
• OpenMRS Project Ideas — a place to look, along with our active tickets, for where you can help
• Information about our weekly Developers Conference Call
• Developer FAQ
• See the currently available Projects

Code of Conduct

The Code of Conduct covers your behavior as a member of the OpenMRS developer community, in any forum, mailing list, wiki, web site, IRC channel, install-fest, public meeting or private correspondence.

Conventions

When developing for OpenMRS, whether in the core code or in modules, please familiarize yourself with the OpenMRS Conventions. In order to successfully collaborate, we must all try our best to abide with some common conventions. Failure to follow these conventions will inevitably cause more work for others, so your attention to them is much appreciated.

Best Practices

In order to help developers discover and follow our conventions, we are evolving a list of OpenMRS Best Practices. Best practices includes things like Code Review Overview.

Subversion Code Repository

Code can be browsed online through Trac.

Code can be downloaded from our Subversion repository with your subversion client using the url http://svn.openmrs.org/openmrs

Explanation of the Subversion Repository Layout and our Subversion Repository Code of Conduct

Submitting Bugs

See our page about submitting bugs

Submitting Patches

See the page about submitting patches to OpenMRS.

Requesting Subversion Repository Access

We welcome any OpenMRS related code into the repository.

All committers will be expected to adhere to the Subversion Repository Code of Conduct and follow the outlined repository conventions.

Requesting a branch

Only major features need be developed in branches (small bug fixes can be submitted via patches -- see [#Submitting_Patches]).

Branches are stored in /openmrs/branches

Send mail to code@openmrs.org. Include:

1. Your trac username
2. Description of the feature your branch will be creating/updating
3. A suggested branch name

Requesting a module

Modules are stored in /openmrs-modules

Send mail to code@openmrs.org. Include:

1. Your trac username
2. Short description of what your module will be doing
3. Your module's id

We invite any developers to keep their OpenMRS-related work in a module, contrib, or branch within the OpenMRS repository. For folks that are making regular contributions, see "how to become a partial committer."

Developer Resources

See Developer Resources