This page will briefly discuss the workflow for releasing Open Web Apps. For a description of what Open Web Apps are, see the wiki page.

To release an Open Web Application(OWA) you need to 

1. Develop the application

This involves ensuring the OWA application meets all the requirements HERE.

2. Host the compiled application on Bintray

To ensure the OWA software distribution and versioning is automated and secure we use Bintray.

Once you make the first release you are welcome to apply for your OWA to be listed under among other OWAs for better recognition within the OpenMRS community. Simply ask for your OWA to be linked on Bintray by posting to Repo Management on Talk. Don't forget to include its Bintray URL in your post.
Anyone, who is a member of the OpenMRS org on Bintray can go to the provided Bintray URL, click "Link", type in "owa" for the repo name and then select the "tick" icon next to "/openmrs/owa" to include the OWA.

After confirming that the OWA has been listed under the packages at this location , a member of the OpenMRS bintray org should then go to the package details and under the Files tab, go to the specific deployed file. It should have an actions menu. Select the option to make the file available under downloads.
This should make the file show as an available file for download on the OWA's bintray url under the General tab

3. Add the released Open Web App to OpenMRS Addon Index:

    Publishing an Add-on

4. Release the App

To release the application, you need to have the necessary privileges. You need to be at least /dev/3, if you are not, ask on and it will be released for you. 

For /dev/3 developers and above,

If you have rights to push to the main repo of the openmrs project you're releasing, you can create tags on your local instance with 

git tag -a v1.4

If your .travis.yml file is configured to release on tags, travis will rebuild when the version tags are pushed to the main repo

5. Create a Talk Post announcing the release

To release an open web application, you need to create a post on OpenMRS Talk detailing information about the application. The aim of the OpenMRS talk post is to inform the community about the new release and get feedback from the users of the OWA and fellow developers.

The blog post should at minimum contain

  1. A link to the OWA Github repository
  2. A list of the modules the OWA depends on
  3. A link to the OWA .zip file hosted by the OpenMRS organization on Bintray.
  4. Some screenshots of the OWA
  5. A list of the developers who worked on the project with their OpenMRS handles.

An example of an OWA release talk post can be found HERE.