aboutsummaryrefslogtreecommitdiffstats
path: root/lists.sr.ht/index.md
blob: 6ab028ba814f42097a6eec493289fb6b9e91c9ce (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
[lists.sr.ht](https://lists.sr.ht) is the sr.ht mailing list service.

**See also**:

- [Installation guide](installation.md)

# New to mailing lists?

We have some resources for you:

- [Mailing list etiquette](etiquette.md)
- [Code review on lists.sr.ht](code-review.md)

Also, see this guide from git.sr.ht:

- [Using git-send-email for sending and reviewing patches on sr.ht](../git.sr.ht/send-email.md)

# lists.sr.ht manual

The following sections document various features of lists.sr.ht.

# Email controls

You may subscribe to any list by emailing
`user/list-name+subscribe@lists.sr.ht`. You may unsubscribe with `+unsubscribe`.
You may post new threads to this list by writing to the address with no `+`
command.

# Dashboard

Your [dashboard](https://lists.sr.ht) 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.

# Profile

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.

# Archive

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.

## Search filters

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
yourself
- `is:patch` only show messages that contain a patch
- `In-Reply-To:` show messages that are replies to a given message ID

Search terms can be surrounded by double-quotes to return exact matches.

# Threads

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.

# List Administration

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:

## Announcement lists

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.

## Write-only security 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.