Skip to content
dinkypumpkin edited this page Sep 29, 2015 · 38 revisions

Contribute to get_iplayer

Code

If you would like to contribute to get_iplayer development, fork the repository on GitHub and submit a pull request with your changes (GitHub account required). See GitHub help documentation for basic information on forking a repo and creating a pull request. The get_iplayer project repo is:

https://github.com/get-iplayer/get_iplayer

Follow a few basic guidelines for pull requests:

  • Each pull request should be submitted from its own feature branch in your fork of the repository. This will make it easier to manage further changes after the pull request is submitted.

  • You should base your feature branch on the develop branch in the get_iplayer repo, so create it similar to:

      git checkout -b feature/goodstuff develop
    
  • Each pull request should contain only one new feature or a fix for a single bug.

  • Each pull request should contain only one commit unless there are exceptional reasons to do otherwise.

  • Each pull request should be independent of changes made in any other pull request.

  • get_iplayer uses tabs for indentation - not spaces - and so must the changes in your pull request.

  • Run git diff --check on your code before committing to ensure you don't have whitespace errors. If you do, fix them before submitting your pull request.

  • Make sure your patches apply cleanly to the current develop branch in the get_iplayer repo, otherwise they may be rejected. Don't expect committers to fix your code.

Documentation

If you would like to contribute new documentation or make changes in existing documentation, you can edit the project wiki (GitHub account required). The get_iplayer project wiki is:

https://github.com/get-iplayer/get_iplayer/wiki

Markdown content is preferred.

Clone this wiki locally