About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


Warning: This page has not been updated in over over a year and may be outdated or deprecated.
development:making_pull_requests

This is an old revision of the document!


Making Pull Requests

Anyone may and is encouraged to make and contribute to pull requests. Since VuFind is so flexible, a lot of libraries add custom functionality to their instances. We're thrilled when developers share this code back with us!

A few suggestions to making a good pull request.

To-Do Lists

To-do lists make it easiest for other developers to see the state of your project. It also adds a progress visualizer to the PR list.

You can create to-do lists in the description of a PR using the following syntax:

 - [ ] This is a to-do.
 - [x] This is a finished to-do.
 - [ ] Waiting to get done.
 - [x] Made to-do list

The formatted to-do list in action.

Labels

Using labels is a good way to get more eyes on your PR.

awaiting reply This label indicates that the VuFind lead developers are waiting for feedback or contributions on this pull request. If you're PR has this label, the ball is in your court!
breaking Changes are significant enough to break backwards compatibility or cause problems in custom themes.
discussion This PR wants your opinion!
help requested This PR is looking for volunteers or feels ignored by the VuFind dev team.
on hold This PR is waiting for another PR or a change outside of our control (dependency update). Please note what the waiting condition is in a comment and/or the description.

And feel free to label your PR with the closest category available:

  • bugfix
  • improvement
  • new feature
development/making_pull_requests.1464099311.txt.gz · Last modified: 2016/05/24 14:15 by crhallberg