{"type":"doc","content":[{"type":"paragraph","content":[{"text":"So that others may use the module you develop, you must ","type":"text"},{"text":"Release","type":"text","marks":[{"type":"em"}]},{"text":" the module.","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend releasing your module to ","type":"text"},{"text":"Bintray","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/"}}]},{"text":". Typically modules are released to a generic omod repository; some projects like OpenMRS code are release as maven repository. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Artifacts published to the maven repository are used by developers and include module's Java API and an OMOD. The omod repository on the other hand is used to distribute modules to implementers, thus only OMODs are published there.","type":"text"}]},{"type":"paragraph","content":[{"text":"Implementers will typically find your module via the ","type":"text"},{"text":"OpenMRS add-ons index","type":"text","marks":[{"type":"link","attrs":{"href":"https://addons.openmrs.org/"}}]},{"text":", so you should get your module indexed there. (It can index modules from various distribution channels including Bintray.)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Release versioning","type":"text"}]},{"type":"paragraph","content":[{"text":"In OpenMRS we adopted the ","type":"text"},{"text":"semantic versioning ","type":"text","marks":[{"type":"link","attrs":{"href":"http://semver.org/"}}]},{"text":"e.g. 1.2.3. As a guideline:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"major new features or complete module rewrites should change the major version (1.2.3 -> 2.0.0)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"minor new features should change the minor version (1.2.3 -> 1.3.0)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bugfixes should change the maintenance version (1.2.3 -> 1.2.4)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Community maintained modules","type":"text"}]},{"type":"paragraph","content":[{"text":"Community maintained modules are available at ","type":"text"},{"text":"https://github.com/openmrs","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs"}}]},{"text":". For those modules developer artifacts are published to the dedicated OpenMRS maven repository at ","type":"text"},{"text":"https://mavenrepo.openmrs.org","type":"text","marks":[{"type":"link","attrs":{"href":"https://mavenrepo.openmrs.org/"}}]},{"text":". Compiled OMODs are published to the Bintray repository at ","type":"text"},{"text":"https://bintray.com/openmrs/omod","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/openmrs/omod"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Thanks to the generosity of the ","type":"text"},{"text":"JFrog ","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.jfrog.com/"}}]},{"text":"company we have virtually unlimited space in the dedicated maven repository, but every new module adds some maintenance on us, thus modules are approved on case-by-case basis. All modules published to the OpenMRS maven repository are automatically published to the Bintray repository without any additional steps. However, it may take up to 3 hours to see the omod on Bintray; check ","type":"text"},{"text":"this Bamboo build if that didn't happen","type":"text","marks":[{"type":"link","attrs":{"href":"https://ci.openmrs.org/browse/AR-DM"}}]},{"text":". If you want to update some details of a module in Bintray, please ask via ","type":"text"},{"text":"Talk","type":"text","marks":[{"type":"link","attrs":{"href":"https://talk.openmrs.org/c/dev/repo-management"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Please see ","type":"text"},{"text":"this page","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25466672"}}]},{"text":" on how to setup a module and do releases to the OpenMRS maven repository.","type":"text"}]},{"type":"paragraph","content":[{"text":"All community supported module releases should be done through CI at ","type":"text"},{"text":"https://ci.openmrs.org/","type":"text","marks":[{"type":"link","attrs":{"href":"https://ci.openmrs.org/allPlans.action"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup Bintray account for Maven","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to be able to release to Bintray you need to create an open source account at ","type":"text"},{"text":"https://bintray.com/signup/oss","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/signup/oss"}}]},{"text":" and set it up as follows.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From your user profile page click \"Add New Repository\". Specify the name and type as \"maven\" and \"Maven\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repeat the 1-st step, creating a new repository of type \"Generic\" and with name \"omod\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add your Bintray credentials to maven's ","type":"text"},{"text":"settings.xml","type":"text","marks":[{"type":"link","attrs":{"href":"https://maven.apache.org/settings.html"}}]},{"text":" as follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n bintray-[YOUR_USERNAME]-maven\n [YOUR_USERNAME]\n [YOUR_PASSWORD]\n ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the first release of your module, you need to request for the module to be included in Bintray's JCenter repository so that it is publicly visible and can be fetched for example with SDK. See","type":"text"},{"text":" Bintray's instructions ","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/docs/usermanual/uploads/uploads_centralrepositories.html#_jcenter"}}]},{"text":"on how to do that.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is also possible to publish SNAPSHOT (development) versions of your module to Bintray. It is particularly useful, if you have a CI server. Refer to ","type":"text"},{"text":"Bintray's docs","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.jfrog.com/confluence/display/RTF/Deploying+Snapshots+to+oss.jfrog.org"}}]},{"text":" on how to do that.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup Bintray maven release","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to be able to release to Bintray you need to add the following snippets to pom.xml in your module (make sure there is only one scm and distributionManagement section in your pom.xml):","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n scm:git:https://github.com/[YOUR_GITHUB_USERNAME]/openmrs-module-[YOUR_MODULE_ID]\n scm:git:https://github.com/[YOUR_GITHUB_USERNAME]/openmrs-module-[YOUR_MODULE_ID]\n https://github.com/[YOUR_GITHUB_USERNAME]/openmrs-module-[YOUR_MODULE_ID]\n \n \n\n \n bintray-[YOUR_BINTRAY_USERNAME]-maven\n [YOUR_BINTRAY_USERNAME]-maven\n https://api.bintray.com/maven/[YOUR_BINTRAY_USERNAME]/maven/openmrs-module-[YOUR_MODULE_ID]/;publish=1\n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Release Checklist","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If JIRA is used for the module to track issues (JIRA privilges for the project are needed, contact the module author):","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that a Version exists for the version ","type":"text"},{"text":"after","type":"text","marks":[{"type":"em"}]},{"text":" the one you're about to release (e.g. if you're releasing 1.7.3, create 1.7.4).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that Versions are in the correct sequential order.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure there are no unclosed issues assigned to the version you want to release.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Issues, which are open (Ready for work, In progress, Pre-commit review), but not committed can be typically bumped to the next version,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Issues, which are in Post-commit review should be reviewed and closed whenever possible. If changes are not stable, they should be reverted and bumped to the next version.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mark the about-to-release version as Released.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the release notes section on the module page in the OpenMRS wiki.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Maven Release","type":"text"}]},{"type":"paragraph","content":[{"text":"Releasing your module to the maven repository can be done with:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn release:prepare release:perform","type":"text"}]},{"type":"paragraph","content":[{"text":"Please see ","type":"text"},{"text":"the maven release plugin documentation","type":"text","marks":[{"type":"link","attrs":{"href":"http://maven.apache.org/maven-release/maven-release-plugin/usage.html"}}]},{"text":" for more details.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Bintray Release","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to publish your module to your 'omod' repository follow ","type":"text"},{"text":"these instructions","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/docs/usermanual/starting/starting_tutorial2uploading.html#_creating_a_package_and_version"}}]},{"text":" (soon to be automated with OpenMRS SDK!).","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you make the first release you are welcome to apply for your module to be listed under ","type":"text"},{"text":"https://bintray.com/openmrs/omod","type":"text","marks":[{"type":"link","attrs":{"href":"https://bintray.com/openmrs/omod"}}]},{"text":" among other modules for better recognition within the OpenMRS community. Simply ask for your module to be linked on Bintray via ","type":"text"},{"text":"Talk","type":"text","marks":[{"type":"link","attrs":{"href":"https://talk.openmrs.org/c/dev/repo-management"}}]},{"text":". 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 \"/openmrs/omod\" for the repo name and click the \"tick\" icon next to it to include the module.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add-ons Release","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"these instructions","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-contrib-addonindex/blob/master/PUBLISHING-AN-ADD-ON.md"}}]},{"text":" for adding your module to the ","type":"text"},{"text":"OpenMRS add-ons index","type":"text","marks":[{"type":"link","attrs":{"href":"https://addons.openmrs.org/"}}]},{"text":". (Your module will be periodically checked for new releases and updated accordingly.)","type":"text"}]}],"version":1}

Browser not supported