Submitting A Patch

From Koha Wiki

Jump to: navigation, search
Home
Koha > Community > Participation
Koha > Technical > Development

When you want to submit a patch to Koha, you should follow the following steps:

  1. create an entry in bugzilla if it does not exist already. Don't forget to set the "change sponsored" field if applicable. There is a default assignee for each component. If you plan to submit a patch yourself, please assign the bug to yourself and set the status to "ASSIGNED" (instead of NEW)
  2. write your patch. Please follow the coding guidelines page
  3. if your patch adds a feature that is sponsored by a library, don't forget to add 'Sponsored-by: xxxx' in your commit comments. This will detected during the release process and the xxxx will be thanked and credited.
  4. format your patch. You can use our Git tutorial if you're new to git
  5. attach your patch to the bug. You can do it through the web interface, or with git bz
  6. update status to "needs sign-off"
  7. choose a value for "patch complexity":
  • string patch = a patch that touches a string or the documentation/POD only
  • trivial patch = a patch that just changes trivial things. Like removing a warn, adding some html in a template,...
  • small patch = a patch that changes only a few Perl things
  • medium patch = a patch that changes many things, with a low-medium side-effect risk, no or small DB changes
  • large patch = a patch that changes many things with a high side-effect risk, large DB change.

Now, you just have to wait for someone taking care of your patch (sign-off and QA) If you need help or want to find someone to test your patch jump on our IRC channel and ask here

Personal tools