[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.

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

[Alyssa Ross]

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

Valentin Gagarin <valentin@gagarin.work> writes:

>>> +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.

Hmm.  I'm not sure what to do then.  The main problem with it is that it
would make it difficult to switch away from Mailman, which I would like
to do eventually since it doesn't seem well-maintained.  (I think
Hyperkitty *can* be used for non-Mailman lists, but I've never seen it
done.)  It's unlikely I'll get to switching any time soon anyway, but
the more people get used to Hyperkitty the more difficult that would be.
It feels like the local maximum is to keep it around while we're using
Mailman for those who know it exists, without growing the set of people
who might be unhappy if it went away.

I do wish somebody would put together a prettier frontend for
public-inbox.

>>> +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.

Whoops, I missed that it was already there.  I think it's probably not
worth the space.

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

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

[Valentin Gagarin]

>> 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.
> 
> Hmm.  I'm not sure what to do then.

Why not take the shutdown option then?  From your argument it sounds 
like that's what you'd prefer.  Is anyone even using it at the moment?