Date: Sat, 22 Jun 2024 15:11:32 -0500
From: Carlos Bilbao <carlos.bilbao.osdev@...il.com>
To: Konstantin Ryabitsev <konstantin@...uxfoundation.org>,
 Jonathan Corbet <corbet@....net>, "David S. Miller" <davem@...emloft.net>,
 Eric Dumazet <edumazet@...gle.com>, Jakub Kicinski <kuba@...nel.org>,
 Paolo Abeni <pabeni@...hat.com>
Cc: workflows@...r.kernel.org, linux-doc@...r.kernel.org,
 linux-kernel@...r.kernel.org, netdev@...r.kernel.org
Subject: Re: [PATCH 1/2] Documentation: fix links to mailing list services

On 6/18/24 11:42, Konstantin Ryabitsev wrote:

> There have been some changes to the way mailing lists are hosted at
> kernel.org, so fix the links that are pointing at the outdated
> resources.
>
> Signed-off-by: Konstantin Ryabitsev <konstantin@...uxfoundation.org>
> ---
>  Documentation/process/2.Process.rst          |  8 ++++----
>  Documentation/process/howto.rst              | 10 +++++-----
>  Documentation/process/kernel-docs.rst        |  5 ++---
>  Documentation/process/maintainer-netdev.rst  |  5 ++---
>  Documentation/process/submitting-patches.rst | 15 +++++----------
>  5 files changed, 18 insertions(+), 25 deletions(-)
>
> diff --git a/Documentation/process/2.Process.rst b/Documentation/process/2.Process.rst
> index 613a01da4717..ef3b116492df 100644
> --- a/Documentation/process/2.Process.rst
> +++ b/Documentation/process/2.Process.rst
> @@ -392,13 +392,13 @@ represent a potential hazard to developers, who risk getting buried under a
>  load of electronic mail, running afoul of the conventions used on the Linux
>  lists, or both.
>  
> -Most kernel mailing lists are run on vger.kernel.org; the master list can
> +Most kernel mailing lists are hosted at kernel.org; the master list can
>  be found at:
>  
> -	http://vger.kernel.org/vger-lists.html
> +	https://subspace.kernel.org
>  
> -There are lists hosted elsewhere, though; a number of them are at
> -redhat.com/mailman/listinfo.
> +There are lists hosted elsewhere; please check the MAINTAINERS file for
> +the list relevant for any particular subsystem.
>  
>  The core mailing list for kernel development is, of course, linux-kernel.
>  This list is an intimidating place to be; volume can reach 500 messages per
> diff --git a/Documentation/process/howto.rst b/Documentation/process/howto.rst
> index eebda4910a88..9438e03d6f50 100644
> --- a/Documentation/process/howto.rst
> +++ b/Documentation/process/howto.rst
> @@ -331,7 +331,7 @@ they need to be integration-tested.  For this purpose, a special
>  testing repository exists into which virtually all subsystem trees are
>  pulled on an almost daily basis:
>  
> -	https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git
> +	https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
>  
>  This way, the linux-next gives a summary outlook onto what will be
>  expected to go into the mainline kernel at the next merge period.
> @@ -373,12 +373,12 @@ As some of the above documents describe, the majority of the core kernel
>  developers participate on the Linux Kernel Mailing list.  Details on how
>  to subscribe and unsubscribe from the list can be found at:
>  
> -	http://vger.kernel.org/vger-lists.html#linux-kernel
> +	https://subspace.kernel.org/subscribing.html
>  
>  There are archives of the mailing list on the web in many different
>  places.  Use a search engine to find these archives.  For example:
>  
> -	https://lore.kernel.org/lkml/
> +	https://lore.kernel.org/linux-kernel/
>  
>  It is highly recommended that you search the archives about the topic
>  you want to bring up, before you post it to the list. A lot of things
> @@ -393,13 +393,13 @@ groups.
>  Many of the lists are hosted on kernel.org. Information on them can be
>  found at:
>  
> -	http://vger.kernel.org/vger-lists.html
> +	https://subspace.kernel.org
>  
>  Please remember to follow good behavioral habits when using the lists.
>  Though a bit cheesy, the following URL has some simple guidelines for
>  interacting with the list (or any list):
>  
> -	http://www.albion.com/netiquette/
> +	https://subspace.kernel.org/etiquette.html
>  
>  If multiple people respond to your mail, the CC: list of recipients may
>  get pretty large. Don't remove anybody from the CC: list without a good
> diff --git a/Documentation/process/kernel-docs.rst b/Documentation/process/kernel-docs.rst
> index 8660493b91d0..3476fb854c7a 100644
> --- a/Documentation/process/kernel-docs.rst
> +++ b/Documentation/process/kernel-docs.rst
> @@ -194,9 +194,8 @@ Miscellaneous
>  
>      * Name: **linux-kernel mailing list archives and search engines**
>  
> -      :URL: http://vger.kernel.org/vger-lists.html
> -      :URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html
> -      :URL: http://groups.google.com/group/mlist.linux.kernel
> +      :URL: https://subspace.kernel.org
> +      :URL: https://lore.kernel.org


Nice!
Reviewed-by: Carlos Bilbao <carlos.bilbao.osdev@...il.com>


>        :Keywords: linux-kernel, archives, search.
>        :Description: Some of the linux-kernel mailing list archivers. If
>          you have a better/another one, please let me know.
> diff --git a/Documentation/process/maintainer-netdev.rst b/Documentation/process/maintainer-netdev.rst
> index 5e1fcfad1c4c..fe8616397d63 100644
> --- a/Documentation/process/maintainer-netdev.rst
> +++ b/Documentation/process/maintainer-netdev.rst
> @@ -25,9 +25,8 @@ drivers/net (i.e. hardware specific drivers) in the Linux source tree.
>  Note that some subsystems (e.g. wireless drivers) which have a high
>  volume of traffic have their own specific mailing lists and trees.
>  
> -The netdev list is managed (like many other Linux mailing lists) through
> -VGER (http://vger.kernel.org/) with archives available at
> -https://lore.kernel.org/netdev/
> +Like many other Linux mailing lists, the netdev list is hosted at
> +kernel.org with archives available at https://lore.kernel.org/netdev/.
>  
>  Aside from subsystems like those mentioned above, all network-related
>  Linux development (i.e. RFC, review, comments, etc.) takes place on
> diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
> index 66029999b587..f310f2f36666 100644
> --- a/Documentation/process/submitting-patches.rst
> +++ b/Documentation/process/submitting-patches.rst
> @@ -119,10 +119,10 @@ web, point to it.
>  
>  When linking to mailing list archives, preferably use the lore.kernel.org
>  message archiver service. To create the link URL, use the contents of the
> -``Message-Id`` header of the message without the surrounding angle brackets.
> +``Message-ID`` header of the message without the surrounding angle brackets.
>  For example::
>  
> -    Link: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/
> +    Link: https://lore.kernel.org/30th.anniversary.repost@klaava.Helsinki.FI
>  
>  Please check the link to make sure that it is actually working and points
>  to the relevant message.
> @@ -243,11 +243,9 @@ linux-kernel@...r.kernel.org should be used by default for all patches, but the
>  volume on that list has caused a number of developers to tune it out.  Please
>  do not spam unrelated lists and unrelated people, though.
>  
> -Many kernel-related lists are hosted on vger.kernel.org; you can find a
> -list of them at http://vger.kernel.org/vger-lists.html.  There are
> -kernel-related lists hosted elsewhere as well, though.
> -
> -Do not send more than 15 patches at once to the vger mailing lists!!!
> +Many kernel-related lists are hosted at kernel.org; you can find a list
> +of them at https://subspace.kernel.org.  There are kernel-related lists
> +hosted elsewhere as well, though.
>  
>  Linus Torvalds is the final arbiter of all changes accepted into the
>  Linux kernel.  His e-mail address is <torvalds@...ux-foundation.org>.
> @@ -866,9 +864,6 @@ Greg Kroah-Hartman, "How to piss off a kernel subsystem maintainer".
>  
>    <http://www.kroah.com/log/linux/maintainer-06.html>
>  
> -NO!!!! No more huge patch bombs to linux-kernel@...r.kernel.org people!
> -  <https://lore.kernel.org/r/20050711.125305.08322243.davem@davemloft.net>
> -
>  Kernel Documentation/process/coding-style.rst
>  
>  Linus Torvalds's mail on the canonical patch format:
>

Thanks,
Carlos

Powered by blists - more mailing lists