[PATCH] Documentation: reword information on mailing lists

[PATCH] Documentation: reword information on mailing lists

[Valentin Gagarin]

Also add links to the tools through which the archives are served.

Signed-off-by: Valentin Gagarin <valentin@gagarin.work>
---
 Documentation/doc/contributing/communication.adoc | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/Documentation/doc/contributing/communication.adoc b/Documentation/doc/contributing/communication.adoc
index 1b6d4d2..8a201cb 100644
--- a/Documentation/doc/contributing/communication.adoc
+++ b/Documentation/doc/contributing/communication.adoc
@@ -21,15 +21,16 @@ link:ircs://irc.libera.chat:6697/spectrum[#spectrum] on https://libera.chat/[Lib
 
 NOTE: Matrix and IRC are https://matrix.org/docs/matrix-concepts/elements-of-matrix/#bridges[bridged].
 
-== Mailing Lists
+== Mailing lists
 
-If you are interested in participating in the project, or even just
-following along with it, the best thing to do is subscribe to one or
-more of the Spectrum mailing lists.
+Subscribe to the https://inbox.spectrum-os.org/[Spectrum mailing lists] to participate in the project or follow along.
 
-Each list has https://inbox.spectrum-os.org/[archives] that can also
-be accessed via the web, NNTP or Atom. If you have the capacity to
-mirror them, please do!
+List archives are served with https://public-inbox.org/README[public-inbox] and only support plain text.
+Each archive can also be accessed through NNTP or Atom.
+
+https://lists.spectrum-os.org/archives/[Archives in web format] are also available through https://docs.mailman3.org/projects/hyperkitty/en/latest/[HyperKitty].
+
+NOTE: If you have the capacity to mirror the mailing list archives, please do!
 
 [#spectrum-announce]
 === announce@spectrum-os.org
-- 
2.54.0

Re: [PATCH] Documentation: reword information on mailing lists

[Alyssa Ross]

[-- Attachment #1: Type: text/plain, Size: 2531 bytes --]

Valentin Gagarin <valentin@gagarin.work> writes:

> Also add links to the tools through which the archives are served.
>
> Signed-off-by: Valentin Gagarin <valentin@gagarin.work>
> ---
>  Documentation/doc/contributing/communication.adoc | 15 ++++++++-------
>  1 file changed, 8 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/doc/contributing/communication.adoc b/Documentation/doc/contributing/communication.adoc
> index 1b6d4d2..8a201cb 100644
> --- a/Documentation/doc/contributing/communication.adoc
> +++ b/Documentation/doc/contributing/communication.adoc
> @@ -21,15 +21,16 @@ link:ircs://irc.libera.chat:6697/spectrum[#spectrum] on https://libera.chat/[Lib
>
>  NOTE: Matrix and IRC are https://matrix.org/docs/matrix-concepts/elements-of-matrix/#bridges[bridged].
>
> -== Mailing Lists
> +== Mailing lists
>
> -If you are interested in participating in the project, or even just
> -following along with it, the best thing to do is subscribe to one or
> -more of the Spectrum mailing lists.
> +Subscribe to the https://inbox.spectrum-os.org/[Spectrum mailing lists] to participate in the project or follow along.
>
> -Each list has https://inbox.spectrum-os.org/[archives] that can also
> -be accessed via the web, NNTP or Atom. If you have the capacity to
> -mirror them, please do!
> +List archives are served with https://public-inbox.org/README[public-inbox] and only support plain text.

This isn't strictly true.  We should be clearer here.

Only plain text is displayed, but we don't completely block HTML emails
like e.g. the kernel lists do.  (I do have to approve them though,
because otherwise so much spam would get through.)

> +Each archive can also be accessed through NNTP or Atom.
> +
> +https://lists.spectrum-os.org/archives/[Archives in web format] are also available through https://docs.mailman3.org/projects/hyperkitty/en/latest/[HyperKitty].

"in web format" is a bit strange.  I consider Hyperkitty a bit legacy,
since I'd originally hoped people could post through it, but that hasn't
worked out.  If it got much harder to keep running I'd probably drop it,
so not sure it's worth directing people to at this point?  It's pretty
clunky and doesn't even look that nice…

(But I'm willing to consider other opinions.)

> +NOTE: If you have the capacity to mirror the mailing list archives, please do!

Think this is worth the space?  I'm not sure how likely it is that
anybody is going to set up a mirror based on a request here.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [PATCH] Documentation: reword information on mailing lists

[Valentin Gagarin]

>> +List archives are served with https://public-inbox.org/README[public-inbox] and only support plain text.
> 
> This isn't strictly true.  We should be clearer here.

Will fix.


> I consider Hyperkitty a bit legacy, 
> since I'd originally hoped people could post through it, but that hasn't 
> worked out.  If it got much harder to keep running I'd probably drop it, 
> so not sure it's worth directing people to at this point?  It's pretty 
> clunky and doesn't even look that nice…

I only put it in there because it seems to have been discussed on the 
mailing list once in a while, and it still seems to be the case that 
it's a more conventional reading experience for most people running into 
Spectrum.  I suggest to either point it out and keep maintaining it, or 
to shut it down and post a note on discuss@spectrum-os.org.  I have no 
opinion on the outcome, I'm just trying to clarify the facts.


>> +NOTE: If you have the capacity to mirror the mailing list archives, please do!
> 
> Think this is worth the space?
I just kept that because the previous content appeared deliberate and 
made sense to me.  Happy to drop it, there's a link on each public-inbox 
front page anyway.