Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Create a new repo in Github (or ask for one for the OpenMRS org from code@openmrs.org)
    1. Name: openmrs-module-yourmoduleid
    2. Description: a one-line description of what the module does (look at others for examples)
    3. Make it public
    4. Initialize with a README
    5. Add .gitignore for maven
  2. Edit the module's pom.xml to use the github address
    No Format
    	<scm>
    		<connection>scm:git:https://github.com/openmrs/openmrs-module-yourmoduleid/</connection>
    		<developerConnection>scm:git:https://github.com/openmrs/openmrs-module-yourmoduleid/</developerConnection>
    		<url>https://github.com/openmrs/openmrs-module-yourmoduleid/</url>
    	</scm>
  3. Change the local repo you just converted to point at that one github repo "origin" (below)
    Code Block
    languagebash
    $ git remote add origin https://github.com/openmrs/openmrs-module-yourmoduleid.git
    Code Block
    languagebash
    $ git pull origin master
  4. Assuming that your module uses the OpenMRS license and it wasn't already in subversion's root, add it:
    Code Block
    languagebash
    wget https://raw.github.com/openmrs/openmrs-core/master/license.txt
  5. Commit your changes locally
    Code Block
    languagebash
    $ git add .
    $ git commit -m "migrating from svn to github"
  6. Push the code to github (below)
    Code Block
    languagebash
    $ git push
    Push the tags manually using the following command.
    Code Block
    languagebash
    $ git push --tags
  7. Add default teams to the new github repository:
    1. Full Committers
    2. Partial Committers
    3. Repo Owners
       
  8. Under the Admin section for the new github repository, make sure Wiki & Issues are unchecked (we don't want wiki & issues going into github; rather, we want people using wiki.openmrs.org and jira.openmrs.org)

Retiring the SVN project

It's important to clearly indicate to other developers that the SVN project is no longer the active repository for the project. After successfully loading the code into github, rather than delete the project, you should:

...