Page Comparison

this guide will walkthrough 

1) going to JIRA to start a change

2 ) creating a development branch

3) checkout out the new branch

link to submitting code pageThis guide will outline the steps needed to begin development. Ready to submit your code? Read the section on Code Submission.

Introduction

OSCAR EMR has adopted the Atlassian suite of tools in streamline the change management process. Observing best practices will greatly reduce the amount of effort needed to integrate code contributions to the official branches.

Branching

OSCAR EMR employs a branching strategy designed to increase efficiency. There are 2 branches a submitter can push code to.

1. master
2. stable

Stable - this branch has full Quality Assurance and is used in production across our user base. This branch accepts bug fixes and feature requests in JIRA.

Master - this branch accepts new Features and Bug fixes. Periodically a new RELEASE branch will be created from master which will eventually be merged into stable.

Learn more about OSCAR EMR's branching strategy.

Creating a development branch

Note: Before completing this step, make sure you've created an issue first.

You can do this step from JIRA or through the command line. An example of both methods has been provided.

JIRA

Beginning from the issue, click on "Create Branch" in the Development panel. 

Note: If you don't see the Development Panel, you must request "Developer" access from OSCAR EMR (link).

Image Added

There are 3 fields available.

Repository - always choose oscaremr/oscar for changes to OSCAR.

Branch from - Choose stable or master as appropriate.

Branch name - Leave the default. If you want something different, just make sure to leave the OSCAREMR-<id> prefix.

Image Added

Select "Create branch", and you are redirected to the Bitbucket page for the new branch and instructions on how to check it out.

Image Added

If you don't already have the code downloaded, make sure you clone the repository first. You can then checkout the branch through the command line, Eclipse or a GIT client such as SourceTree.

Command Line