about summary refs log tree commit diff
path: root/participating.html
blob: 6fe9a8097f747a8617ea40471333760cb7151051 (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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
<!doctype html>
<html lang="en">

<head>

<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">

<link rel="stylesheet" href="style.css">

<title>Participating in Spectrum</title>

<body>

<nav>
  <a href="..">Spectrum</a>
</nav>

<h1>Participating in Spectrum</h1>

<p>
There are several places online in which announcements, discussion,
and collaboration happen.  Rather than tell you about them all at
once, though, it's best to tell you which ones are relevant to you,
given how you'd like to participate (or not) in the project.

<p>
Our primary methods of communication are mailing lists and IRC.  If
this isn't how you're used to interacting with free software projects,
<strong>DON'T PANIC</strong>.

<p>
We provide instructions for how to get started, and several different
interfaces for you to choose from depending on what workflow (web,
mail, Atom, etc.) makes you most comfortable.  Details of these will
be explained further on, but first, you should figure out what
communication channels are actually relevant for you.

<p>
If you want to post to the mailing list, and are not planning on using
the <a href="https://spectrum-os.org/lists/hyperkitty">web UI</a>,
you <em>will</em> need to disable HTML mail in your client.
Instructions for how to do that are
probably <a href="https://useplaintext.email/">available</a> for your
mail client of choice.

<p>
If you're interested in keeping up to date with announcements from
Spectrum's developers, you should subscribe
to <a href="#spectrum-announce">spectrum-announce</a>.  You can
discuss Spectrum and related topics in real time
on <a href="#irc"><abbr title="Internet Relay Chat">IRC</abbr></a>, or
more long-form on <a href="#spectrum-discuss">spectrum-discuss</a>.
Finally, development work happens in
Spectrum's <a href="https://spectrum-os.org/git/">source
repositories</a>, and is discussed
on <a href="#spectrum-devel">spectrum-devel</a>.  There's another page
that goes into more detail
about <a href="contributing.html">contributing to Spectrum's
development</a>.

<h2 id="irc">IRC</h2>

<p>
There is a single IRC
channel, <a href="ircs://chat.freenode.net:6997/spectrum">#spectrum</a>
on Freenode, for all kinds of Spectrum discussions.  If you're new to
IRC, you might find
Freenode's <a href="https://webchat.freenode.net/#spectrum">web
chat</a> the easiest way to get started.  The channel
is <strong>logged</strong>, and the logs
are <a href="https://logs.spectrum-os.org/spectrum/">published</a> on
the web.

<h3>Note for Matrix users</h3>

<p>
There appears to be an issue with Matrix's IRC bridge that prevents
Matrix users from joining #spectrum.  The workaround is as follows:

<ol>
  <li>Post <q>!join #spectrum</q> in your "Freenode IRC Bridge" chat.</li>
  <li>Accept the invitation you are sent.</li>
</ol>

<p>
If you experience this issue, kindly report it to the people who run
the Matrix IRC bridge.  If you are able to join the channel without
the workaround, please report that in #spectrum so the website can be
updated.

<h2 id="mailing-lists">Mailing lists</h2>

<p>
If you're 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.

<p>
If mailing lists aren't your thing, that's okay!  Try
the <a href="https://spectrum-os.org/lists/hyperkitty/">web UI</a>, which allows you to
interact with the mailing lists much like a modern web forum.

<p>
Each list
has <a href="https://spectrum-os.org/lists/archives/">archives</a>
that can also be accessed via the web, NNTP or Atom.  You are strongly
encouraged to mirror them.

<h3 id="spectrum-announce">announce@spectrum-os.org</h3>

<p>
This is a one-way list where announcements from Spectrum's developers
will be posted.

<p>
You can
subscribe <a href="https://spectrum-os.org/lists/postorius/lists/announce.spectrum-os.org/">on
the web</a>, or by sending mail
to <a href="mailto:announce-subscribe@spectrum-os.org">announce-subscribe@spectrum-os.org</a>.

<h3 id="spectrum-discuss">discuss@spectrum-os.org</h3>

<p>
This list contains high-level discussion about the project.

<p>
You can
subscribe <a href="https://spectrum-os.org/lists/postorius/lists/discuss.spectrum-os.org/">on
the web</a>, or by sending mail
to <a href="mailto:discuss-subscribe@spectrum-os.org">discuss-subscribe@spectrum-os.org</a>.

<h3 id="spectrum-devel">devel@spectrum-os.org</h3>

<p>
This list is for the nitty-gritty of development.  It's where
low-level technical discussions happen, and where patches are sent.

<p>
There's a <a href="/contributing.html">separate guide</a> for the Spectrum
development process, including how patches are sent to this list and
discussed.

<p>
You can
subscribe <a href="https://spectrum-os.org/lists/postorius/lists/devel.spectrum-os.org/">on
the web</a>, or by sending mail
to <a href="mailto:devel-subscribe@spectrum-os.org">devel-subscribe@spectrum-os.org</a>.

<p>
<small>You may distribute this content under the terms of either
the <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA</a>
license (version 4.0 or later), or
the <a href="https://www.gnu.org/licenses/gfdl.html">GNU Free
Documentation License</a> (version 1.2 or later), at your
option.</small>