User Tools

Site Tools


userdoc:patchwork

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
userdoc:patchwork [2018-11-23 17:58]
mricon
userdoc:patchwork [2020-05-08 14:58] (current)
mricon
Line 1: Line 1:
 +~~REDIRECT>​https://​korg.docs.kernel.org/​patchwork/​index.html~~
 +
 ====== How to request a new project on patchwork ====== ====== How to request a new project on patchwork ======
  
Line 18: Line 20:
   - Summary to: (e.g. example@kernel.org,​ example@gmail.com)   - Summary to: (e.g. example@kernel.org,​ example@gmail.com)
   - Notify submitters?:​ (yes/no)   - Notify submitters?:​ (yes/no)
 +  - (If yes on previous) Cc the list on notifications?​ (yes/no)
 +  - Auto-supersede series? (yes, within NN days/no)
 +  - Auto-archive old patches? (yes, when older than NN days/no)
 +
 +==== Auto-superseding series and archiving old patches ====
 +
 +The bot can do some basic housekeeping chores, such as automatically marking patches belonging to older versions of the series as "​superseded."​ E.g. if a contributor sends "''​[PATCH NN/30] Do foo to bar''",​ and then after that a new revision "''​[PATCH NN/30 v2] Do foo to bar''",​ the bot can automatically mark the 30 patches belonging to the "''​v1''"​ of the series as "​superseded"​. In order to work, the following conditions must be met:
 +
 +  - It must be submitted by the same person
 +  - It must have the exact same series name (first patch or cover letter subject wording)
 +  - It must be within the cutoff period of days specified. In other word, if the cutoff is 90 days and the new series comes in 4 months later, there will be no match
 +
 +Similarly, the bot can archive patches older than a certain period of time if they are still in the "​New"​ state.
 +
 +==== Notifying submitters ====
 +
 +If you choose to notify submitters, it would send them a summary email per each series that was marked as accepted, for example:
 +
 +<​file>​
 +Subject: Re: [PATCH v3,00/03] Apply foo to bar
 +From: patchwork-bot+project-name@kernel.org
 +To: Submitter Name <​submitter@kernel.org>​
 +
 +Hello:
 +
 +This series was applied to shuah/​linux-kselftest (refs/​heads/​fixes).
 +
 +On Fri, 07 Dec 2018 11:09:48 +0100 you wrote:
 +> The foo is not applied to bar, but it should be.
 +>
 +> Signed-off-by:​ Awesome Contributor <​awesome@example.com>​
 +
 +Here is a summary with links:
 +  - [1/3] Apply foo to bar
 +    https://​git.kernel.org/​[...]
 +  - [2/3] Apply foo to bar with more conviction
 +    https://​git.kernel.org/​[...]
 +  - [3/3] Apply foo to bar for real this time
 +    https://​git.kernel.org/​[...]
 +
 +You are awesome, thank you!
  
 +--
 +Deet-doot-dot,​ I am a bot.
 +https://​korg.wiki.kernel.org/​userdoc/​pwbot
 +</​file>​
  
 +This way, if you are applying a series of 50 patches from the same person, the submitter will only receive a single notification email.
userdoc/patchwork.1542995905.txt.gz ยท Last modified: 2018-11-23 17:58 by mricon