Submitting a code patch

From CKAN

CKAN is an Open Source project and we welcome code from contributors that share the CKAN goal of providing access to open data.

These instructions show how easy it is to suggest a small change in our code, or submit a patch. (If you want to contribute regularly we suggest you look at Becoming a CKAN Developer.

Github fork

Probably the simplest method if you have a github account and definitely preferred for larger changes.

1. Register/Log-in to GitHub
2. Visit the CKAN repo on github: http://github.com/okfn/ckan
3. Click on the fork button at top right (blue arrow pointing diagonally upwards)
4. You'll then have a cloned version which you can either edit directly on clone to your local machine (see instructions on github)
5. Make your changes to the code
6. Push to your repo: git push

Then you'll want to submit the pull request (i.e. a request for your fixes to be incorporated):

1. Send a 'pull' request (to get it merged into the okfn github). On your GitHub fork (e.g. https://github.com/bob/ckan ) click 'send pull request'
2. All being well, an OKF CKAN developer will integrate it into a suitable CKAN release.

Email a patch

1. Ensure you have a copy of the CKAN code from Github (i.e. not from an apt repository). To do this, see the CKAN documentation: Install from source
2. Make your changes to the code
3. Create the patch:

 $ git diff > my_new_feature.patch

1. Email the patch to ckan-dev with your comments.
2. All being well, an OKFN CKAN developer will integrate it into a suitable CKAN release.

  write my essay