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

[Alyssa Ross <hi@alyssa.is>]

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