From LinuxMIPS
Revision as of 17:40, 2 December 2011 by Ralf (talk | contribs) (See also: Use protocol independent URL.)
Jump to: navigation, search

Patchwork is a web-based patch tracking system designed to facilitate the contribution and management of contributions to an open-source project. Patchwork is a web-based patch tracking system designed to faciliate the contribution and managment of contributions to an open-source project. Patches that have been sent to a mailing list - the linux-mips list in this case - are 'caught' by the system, and appear on a web page. Any comments posted that reference the patch are appended to the patch page too.

The project's maintainer can then scan through the list of patches, marking each with a certain state, such as Accepted, Rejected or Under Review. Old patches can be sent to the archive or deleted. A patch submitter can change the status of his patches for example when finding a bug or submitting a new version.

Why is patchwork a good thing?

It allows a maintainer to keep a good overview over all the pending patches. Unlike many previous systems that were implemented or suggested it doesn't get into the way of established patch submission and handling practices but rather provides a tool to automate a part of necessary procedures.

What does patchworks mean for patch submissions?

Patchwork is subscribed to the linux-mips mailing list. So it will only keep track of patches that have been posted to the linux-mips mailing list but not of patches that have been sent in private to me. This is a problem so I'm considering to reject patches that have not been submitted to the mailing list as a matter of policy.

Beyond that it's largely up to the patch submitter. For a submitter who doesn't use patchwork things will work the same way they used to work.

What new advanced features deos patchwork offer to submitters?

Submitters can create an account on patchworks. They can change the status of their patches - which are identified as theirs by the submitter's email address - for example when they wish withdraw a patch because it was found faulty or are about to send a better revision.

There is also a feature to create patch bundles from several patches which then can be downloaded as a single download.

Which patches are tracked in patchwork?

I've installed patchworks about four weeks ago. For testing purposes and also to ensure I've not dropped anything on the floor I've fed the mailing list archives back to June 2009 into patchworks, then manually walked through the hundreds of patches to ensure all patches have been handled.

If you've sent patches that have not been applied yet and don't show up in patchworks as new or under review, then please resent your patches.

See also