HOWTO Submit a patch to jQuery UI using the GitHub web interface

HOWTO Submit a patch to jQuery UI using the GitHub web interface

Example: you want to submit a patch to the Datepicker file, jquery.ui.datepicker.js, but you heard svn is out and git is in.

Step 1: Sign up for GitHub (jump on it)

Step 2: Fork the jQuery UI repository (become a committer of your very own copy of jQuery UI)

Step 3: Modify your fork through the GitHub web interface (commit your change without knowing git)
  • http://github.com/{your-username}/jquery-ui
  • Click on the folder and file you want to modify
    • click "ui/"
    • click "jquery.ui.datepicker.js"
  • When you're viewing the contents of the file you want to change, click "edit"
  • Make changes to the file in the editor
  • Enter a Commit Message to summarize the changes you've made and why you've made them. This should include a reference to a Trac ticket, formatted like so
    • "Changed ... and ... datepicker done right. Fixes #3945 - Datepicker does not respond to any click events in AIR"
  •  Click "Commit"

Step 4: Submit a Pull Request (tell the jQuery UI team why your change rocks)
  • http://github.com/{your-username}/jquery-ui/blob/{id-of-commit}/ui/jquery.ui.datepicker.js
  • Click "Pull Request"
  • Enter a Message that will go with your commit to be reviewed by core committers
  • Click "Send Pull Request"

Step 5: Add a link to your commit to the ticket in Trac (tell everyone you're on the case)

Step 6: Eat a cookie (yum)
  • Note: this step is :not(optional)

Note: if you need to change multiple files as part of one commit, the web interface will not be the way to go. In that case you'll want to learn a little more about github and git. You can start here: