lists.code.netlandish.com is the code.netlandish.com mailing list service.
Note: This document was taken from the sourcehut documentation. It's been adapted to fit our setup where appropriate.
We have some resources for you:
If you plan on contributing patches, we also have these guides:
The following sections document various features of lists.code.netlandish.com.
You may post to a list that you have posting permissions on by writing a
plaintext email to ~user/list-name@lists.code.netlandish.com. If your MTA
doesn't support characters like ~ and / in emails, please write to
postmaster@your-mta.com asking them to fix the bug, then use
u.username.list-name@lists.code.netlandish.com instead.
You may subscribe to any list by emailing
~user/list-name+subscribe@lists.code.netlandish.com. You may unsubscribe with
+unsubscribe. You may post new threads to this list by writing to the address
with no + command.
Your dashboard shows you recent emails on mailing lists you're subscribed to. You can reply to one by clicking the author's name, or view the thread by clicking the subject.
Your public profile page shows a feed of emails authored by you, as well as a list of mailing lists you administrate. Like the dashboard, emails can be replied to by clicking the authors name and you can view the thread by clicking the subject.
Each list shows a list of archives, sorted by which has seen the most recent activity. In each thread's heading, you can see the number of participants, number of replies, and subject of the initial message. Click the subject to see the full thread.
List archives can be searched using the search bar at the top. Filters that can be used include:
from: the author of the message. Use me to search for messages sent by
yourselfis:patch only show messages that contain a patchIn-Reply-To: show messages that are replies to a given message IDmessage-id: find message with a given message IDSearch terms can be surrounded by double-quotes to return exact matches.
Email threads can become trees as participants reply to different messages. In the simple case of a linear thread, you will see replies written linearly. However, if a thread becomes split, you may see several linear trees of discussion form.
To reply to a message, click the author's email address.
Additionally, messages in the thread can be downloaded in raw form, either
individually or as a whole in an mbox format. This is useful for applying
submitted patches via git am/hg import among other uses.
Raw individual messages can be found by clicking on "Details" and following the link there.
Mbox files can be downloaded by clicking on "Export thread (mbox)" on the sidebar.
List access controls are available on your list settings, which can be accessed with the "List settings" button on the list archive. The controls are fine-grained enough to support many access scenarios, here are some examples:
A list that only you can write to is useful for announcements. Remove all user's "post" and "reply" permissions to prevent them from submitting - owners are always able to post. You can optionally leave the "reply" permission enabled to allow people to respond to announcements, but be aware that their responses will be sent out to all subscribers, which is usually undesirable for low-volume announcement lists.
If you want a mailing list where people can write to you about security vulnerabilities in your software, you can remove the "browse" permission without removing the "post" or "reply" permissions from the list. This will allow people to send emails to the list, but not view the archives or subscribe.
commit 36e61708da5f61231d230c77e8580e20219ffdf7 Author: Peter Sanchez <peter@netlandish.com> Date: 2022-07-25T12:07:27-06:00 Adding Drew Devault link to contributing doc