From: Geert Uytterhoeven <geert@linux-m68k.org>
To: Steven Rostedt <rostedt@goodmis.org>
Cc: Konstantin Ryabitsev <konstantin@linuxfoundation.org>,
Jonathan Corbet <corbet@lwn.net>,
Carlos Bilbao <carlos.bilbao.osdev@gmail.com>,
"David S. Miller" <davem@davemloft.net>,
Eric Dumazet <edumazet@google.com>,
Jakub Kicinski <kuba@kernel.org>, Paolo Abeni <pabeni@redhat.com>,
workflows@vger.kernel.org, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org, netdev@vger.kernel.org,
ksummit@lists.linux.dev
Subject: Re: [PATCH 2/2] Documentation: best practices for using Link trailers
Date: Wed, 26 Jun 2024 10:12:35 +0200 [thread overview]
Message-ID: <CAMuHMdXHa52RBjzA4eF4ERNuJjRHyq=FfyPz-yOsjOA7ZQfouQ@mail.gmail.com> (raw)
In-Reply-To: <20240625172727.3dd2ad67@rorschach.local.home>
Hi Steven,
On Tue, Jun 25, 2024 at 11:27 PM Steven Rostedt <rostedt@goodmis.org> wrote:
> On Tue, 18 Jun 2024 12:42:11 -0400
> Konstantin Ryabitsev <konstantin@linuxfoundation.org> wrote:
> > + A similar approach was attempted before as part of a different
> > + effort [1], but the initial implementation caused too many
> > + regressions [2], so it was backed out and reimplemented.
> > +
> > + Link: https://lore.kernel.org/some-msgid@here # [1]
> > + Link: https://bugzilla.example.org/bug/12345 # [2]
> > +
> > + When using the ``Link:`` trailer to indicate the provenance of the
> > + patch, you should use the dedicated ``patch.msgid.link`` domain. This
> > + makes it possible for automated tooling to establish which link leads
> > + to the original patch submission. For example::
> > +
> > + Link: https://patch.msgid.link/patch-source-msgid@here
>
> Hmm, I mentioned this in the other thread, but I also like the fact
> that my automated script uses the list that it was Cc'd to. That is, if
> it Cc'd linux-trace-kernel, if not, if it Cc'd linux-trace-devel, it
> adds that, otherwise it uses lkml. Now, I could just make the lkml use
> the patch-source-msgid instead.
>
> This does give me some information about what the focus of the patch
> was. Hmm, maybe I could just make it:
>
> Link: https://patch.msgid.link/patch-source-msgid@here # linux-trace-devel
>
> Would anyone have an issue with that?
Or, just like with lore links:
https://patch.msgid.link/linux-trace-devel/patch-source-msgid@here
Gr{oetje,eeting}s,
Geert
--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org
In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds
next prev parent reply other threads:[~2024-06-26 8:12 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-06-18 16:42 [PATCH 0/2] Documentation: update information for mailing lists Konstantin Ryabitsev
2024-06-18 16:42 ` [PATCH 1/2] Documentation: fix links to mailing list services Konstantin Ryabitsev
2024-06-18 18:15 ` Dan Williams
2024-06-22 20:11 ` Carlos Bilbao
2024-06-18 16:42 ` [PATCH 2/2] Documentation: best practices for using Link trailers Konstantin Ryabitsev
2024-06-19 7:12 ` Leon Romanovsky
2024-06-19 14:24 ` Konstantin Ryabitsev
2024-06-19 8:08 ` Dan Carpenter
2024-06-19 8:41 ` Michael S. Tsirkin
2024-06-19 8:53 ` Michael S. Tsirkin
2024-06-19 8:50 ` Jani Nikula
2024-06-19 9:08 ` Michael S. Tsirkin
2024-06-20 8:45 ` Thorsten Leemhuis
2024-06-22 20:10 ` Carlos Bilbao
2024-06-25 21:27 ` Steven Rostedt
2024-06-26 8:12 ` Geert Uytterhoeven [this message]
2024-06-26 14:16 ` Konstantin Ryabitsev
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAMuHMdXHa52RBjzA4eF4ERNuJjRHyq=FfyPz-yOsjOA7ZQfouQ@mail.gmail.com' \
--to=geert@linux-m68k.org \
--cc=carlos.bilbao.osdev@gmail.com \
--cc=corbet@lwn.net \
--cc=davem@davemloft.net \
--cc=edumazet@google.com \
--cc=konstantin@linuxfoundation.org \
--cc=ksummit@lists.linux.dev \
--cc=kuba@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=netdev@vger.kernel.org \
--cc=pabeni@redhat.com \
--cc=rostedt@goodmis.org \
--cc=workflows@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox