Skip to content

Commit 65321bb

Browse files
committed
doc: add reference to full email address and purpose for lists
Added purpose for lists to the mailing list table. Also added headers. Some grammar fixups. Promote WebChat IRC interface over client interface as many people don't have clients installed anymore 8-(. Added a sentence that guides the user to the address of the mailing list. I added this after getting an issue about a request that should have gone to the mailing list. I realised there was no reference to the mailing lists' domain: @lists.sourceforge.net on the contact page. I think the linked subscribe page used to provide a hint, but it doesn't look like it does anymore. I wonder if we should add a mailto: link there? Does sphinx obscure it enough to prevent bot spamming?
1 parent 63a8954 commit 65321bb

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

website/www/contact.txt

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,22 @@ We maintain the following mailing lists:
1212

1313
.. rst-class:: linkspacing
1414

15-
=================== ==========================
16-
roundup-users_ archives `[SourceForge]`__
17-
roundup-devel_ archives `[SourceForge]`__
18-
roundup-checkins_ archives `[SourceForge]`__
19-
=================== ==========================
15+
=================== ========================== ===============================
16+
List Name/Signup Archive link Purpose
17+
=================== ========================== ===============================
18+
roundup-users_ archives `[SourceForge]`__ how to use Roundup
19+
roundup-devel_ archives `[SourceForge]`__ develop new Roundup releases
20+
roundup-checkins_ archives `[SourceForge]`__ automated check-in messages
21+
=================== ========================== ===============================
22+
23+
These lists are open-access, but moderated to protect them against spam.
24+
The email address is
25+
``<the list name from above>@lists.sourceforge.net``.
2026

21-
These lists are moderated to protect them against spam.
2227
Please sign up if you intend to mail repeatedly.
2328

24-
You may talk to Roundup developers directly via IRC irc://irc.oftc.net/roundup
25-
using IRC client or through WebChat_ interface.
29+
You may talk to Roundup developers directly using the `WebChat IRC`_
30+
interface. You can also use an IRC client: irc://irc.oftc.net/roundup.
2631

2732

2833
.. _roundup-users: https://sourceforge.net/projects/roundup/lists/roundup-users
@@ -35,4 +40,4 @@ using IRC client or through WebChat_ interface.
3540

3641
.. __: https://sourceforge.net/p/roundup/mailman/roundup-checkins/
3742

38-
.. _WebChat: https://webchat.oftc.net/?randomnick=1&channels=roundup&prompt=1
43+
.. _WebChat IRC: https://webchat.oftc.net/?randomnick=1&channels=roundup&prompt=1

0 commit comments

Comments
 (0)