- If you don't have one, create an OpenMRS ID, which you can use to contribute to this Wiki, manage issues in JIRA, and more.
- Sign up for the developer (and maybe implementer) mailing lists. The developers mailing list is a great place to ask specific questions if you get stuck along the way (if you can't find answers elsewhere).
- Since we moved from the mailing list,its important to acquire an id so as you can continue to interact with the community. We are currently using http://talk.openmrs.org
- Create an account at https://github.com/
- Configure your Eclipse environment with the Step-by-Step Installation for Developers. The New Developer's Guide has a helpful chapter on Setting Up Your Development Environment.
- Watch some OpenMRS development screen-casts on YouTube.
- Create your first OpenMRS module. The New Developer's Guide features a chapter on how to create a Hello World Module.
- Find some introductory issues (also shown below) that have the "Ready for Work" status to work on, and assign them to yourself by clicking the Claim Issue button. (Ask for clarification on the issue if needed.) If you find yourself taking long (days) without making any progress, feel free to un-assign yourself from the issue and choose another.
- Try as much as you can to include unit tests for your changes. Remember to also do an "mvn clean install" to ensure that all existing unit tests and yours pass. Then create a pull request. If your changes affect the user interface, please run the web application to see the effects, and then attach a screenshot, before you commit.
- Log your time spent on that issue and click "Request Code Review" and a core developer will get you some feedback in short order
- Find another issue or choose a larger project to work on. See Unassigned Projects.
- If you join a sprint or choose to share your module (we hope you do), then you'll want to read about Using Git.
- When you no longer want to work on an issue that you have already assigned to yourself, please remember to un-assign yourself from it such that others can take it up. If you have any findings that you feel would be useful to whoever takes it up, please feel free to add a comment.
Please record your experiences (good or bad) on this child page. We are always trying to find ways to improve where we can do better and reinforce things we are doing well, so getting input from your perspective is very helpful & appreciated.
Current Sprint Issues
At all times, we have an ongoing Development Sprint.
For each sprint, we include issues of low complexity which are suitable for developers who are getting started with OpenMRS. We therefore encourage you to look in this pool of issues when looking for which to work on. Because a sprint has a number of developers working on a set of related features at the same time, working on it will give you the advantage of getting more immediate feedback in terms of responses to blocker questions, reviewing of your code, mentoring and guidance regarding how to do the issues, pair programming where necessary, and more.
The following issues are both "introductory" and also "curated", meaning that they have thorough descriptions of how to approach solving them:
If you aren't able to find an appropriate issue in the list above, here is the complete list of "introductory" issues, not necessarily "curated":
After Introductory Issues
After doing a couple of introductory issues, you may feel like working on issues of increased complexity. Or you may find the introductory issues boring and hence want to work on something more exciting.
Should you find yourself in this state, the active Development Sprint may be a good place for you to look next. The sprint has issues for all levels of complexity. The Sprint Schedule will always be updated with the active or current development sprint.
Here is a backlog of tickets prioritized by the community:
|UIFR-199||-DuiFramework.development.moduleid vm argument should support multiple folders||2016-01-21||2016-02-01||Unassigned||Daniel Kayiwa||Ready for Work||Unresolved|
|TRUNK-4822||Fix broken CI plan for MariaDB Docker test||2016-02-01||2016-02-02||Unassigned||Wyclif Luyima||Needs Assessment||Unresolved|
|TRUNK-4821||Fix broken CI plan for OpenMRS on MariaDB||2016-02-01||2016-02-02||Unassigned||Wyclif Luyima||Needs Assessment||Unresolved|
|TRUNK-4820||Fix broken CI plan for MySQL with OpenMRS||2016-02-01||2016-02-02||Unassigned||Wyclif Luyima||Needs Assessment||Unresolved|
|TRUNK-4809||Identify features not exposed via webservices.rest||2016-01-14||2016-02-01||Daniel Kayiwa||Mayank Sharma||In Progress||Unresolved|
|TRUNK-4765||Upgrade path from OpenMRS 1.9 to Platform 2.0 + Legacy UI||2015-10-02||2016-02-06||Shashank Motepalli||Mayank Sharma||In Progress||Unresolved|
|TRUNK-4747||Move Allergies API into the core platform||2015-08-17||2016-02-06||James deGraft-Johnson||Daniel Kayiwa||Reopened||Unresolved|
|RESTWS-496||Handle internal errors gracefully, make them self-explanatory||2015-03-25||2016-02-02||Unassigned||Lluis Martinez||Ready for Work||Unresolved|
|RESTWS-466||REST custom representation of encounter : exception thrown if no preferredName||2014-10-27||2015-12-13||Unassigned||Jonathan Dick||Ready for Work||Unresolved|
|RESTWS-439||Get concepts throws exception when concept numeric fields are included in custom representation||2014-05-06||2015-12-13||Unassigned||Deepak N||Ready for Work||Unresolved|
|RESTWS-419||WS-REST date parsing not *quite* ISO 6801 compatible||2014-02-26||2016-01-07||Stephen Senkomago Musoke||Mark Goodrich||In Progress||Unresolved|
|RESTWS-362||Add search for subresources||2013-02-25||2016-02-04||Unassigned||Rafal Korytkowski||Ready for Work||Unresolved|
|RA-1001||Update all modules that use Transifex to support all languages we support||2016-01-28||2016-01-28||Unassigned||Mark Goodrich||Waiting for Dev||Unresolved|
|RA-1000||Automatically pull translations into modules as part of their release process||2016-01-28||2016-01-28||Unassigned||Darius Jazayeri||Waiting for Analysis||Unresolved|
|RA-951||Bug loading in JSON for App Configuration, config parameters are not read in properly||2015-11-06||2016-01-21||Unassigned||James Arbaugh||Waiting for Dev||Unresolved|
|RA-435||Need way to edit implementation custom forms||2014-10-09||2016-02-01||Unassigned||James Arbaugh||Waiting for Dev||Unresolved|
|OWA-1||Demonstrate a best-practice example of build process for an HTML+JS+CSS open web app||2016-01-20||2016-01-20||Unassigned||Darius Jazayeri||Ready for Work||Unresolved|
|LUI-33||Issue with greek characters when updating from 1.10.2 to 1.11.3||2015-10-06||2016-02-08||pralay ramteke||Daniel Kayiwa||In Progress||Unresolved|
|LUI-32||Error creating patient for large location IDs > 1000||2015-10-15||2016-01-24||Owais Hussain||Tahira Niazi||In Progress||Unresolved|
|HTML-319||Add a New Tag to support editing Person Attributes via HTML forms||2012-03-06||2016-01-20||Unassigned||Tobin Greensweig||Ready for Work||Unresolved|
You could also do code reviews for pull requests.