Commit 7e7b3b09 authored by Jakub Kicinski's avatar Jakub Kicinski

docs: netdev: document the existence of the mail bot

We had a good run, but after 4 weeks of use we heard someone
asking about pw-bot commands. Let's explain its existence
in the docs. It's not a complete documentation but hopefully
it's enough for the casual contributor. The project and scope
are in flux so the details would likely become out of date,
if we were to document more in depth.

Link: https://lore.kernel.org/all/20230522140057.GB18381@nucnuc.mle/Reviewed-by: default avatarAndrew Lunn <andrew@lunn.ch>
Reviewed-by: default avatarSimon Horman <simon.horman@corigine.com>
Link: https://lore.kernel.org/r/20230522230903.1853151-1-kuba@kernel.orgSigned-off-by: default avatarJakub Kicinski <kuba@kernel.org>
parent 8a02fb71
...@@ -127,13 +127,32 @@ the value of ``Message-ID`` to the URL above. ...@@ -127,13 +127,32 @@ the value of ``Message-ID`` to the URL above.
Updating patch status Updating patch status
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
It may be tempting to help the maintainers and update the state of your Contributors and reviewers do not have the permissions to update patch
own patches when you post a new version or spot a bug. Please **do not** state directly in patchwork. Patchwork doesn't expose much information
do that. about the history of the state of patches, therefore having multiple
Interfering with the patch status on patchwork will only cause confusion. Leave people update the state leads to confusion.
it to the maintainer to figure out what is the most recent and current
version that should be applied. If there is any doubt, the maintainer Instead of delegating patchwork permissions netdev uses a simple mail
will reply and ask what should be done. bot which looks for special commands/lines within the emails sent to
the mailing list. For example to mark a series as Changes Requested
one needs to send the following line anywhere in the email thread::
pw-bot: changes-requested
As a result the bot will set the entire series to Changes Requested.
This may be useful when author discovers a bug in their own series
and wants to prevent it from getting applied.
The use of the bot is entirely optional, if in doubt ignore its existence
completely. Maintainers will classify and update the state of the patches
themselves. No email should ever be sent to the list with the main purpose
of communicating with the bot, the bot commands should be seen as metadata.
The use of the bot is restricted to authors of the patches (the ``From:``
header on patch submission and command must match!), maintainers themselves
and a handful of senior reviewers. Bot records its activity here:
https://patchwork.hopto.org/pw-bot.html
Review timelines Review timelines
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment