contribute.mdwn 8.8 KB
Newer Older
1
[[!meta title="Contributing to Tails"]]
2

3
4
5
There are many ways you can contribute to Tails. No effort is too
small and whatever you bring to this community will be appreciated.
So read on to find out how you can make a difference in Tails.
6
7

<div class="contribute-roles-1">
8
<h2>Share your experience</h2>
9
<div class="contribute-role" id="user">
Tails developers's avatar
Tails developers committed
10
  [[!img user.png link=no]]
Tails developers's avatar
Tails developers committed
11
  <p>Every user can help others or provide developers with useful information.</p>
12
13
  <ul>
    <li>[[Report bugs|doc/first_steps/bug_reporting]]</li>
Tails developers's avatar
Tails developers committed
14
15
    <li>[[Test experimental ISO images|contribute/how/testing]]</li>
    <li>[[Provide input to developers|contribute/how/input]]</li>
16
17
18
19
20
21
22
23
    <li>[[Help other Tails users|contribute/how/help]]</li>
  </ul>
</div>
</div>

<div class="contribute-roles-1">
<h2>Donate</h2>
<div class="contribute-role" id="donate">
Tails developers's avatar
Tails developers committed
24
  [[!img donate.png link=no]]
25
  <p>Donating speeds up the development of Tails.</p>
26
  <ul>
27
    <li><a href="https://tails.boum.org/donate/?r=contribute">Make a donation</a></li>
28
29
30
31
32
  </ul>
</div>
</div>

<div class="contribute-roles-3">
33
<h2>Contribute your language skills</h2>
34
35
<div class="contribute-role" id="content-writer">
  <h3>Writer</h3>
Tails developers's avatar
Tails developers committed
36
  [[!img writer.png link=no]]
37
  <p>Good writers can make Tails accessible to more people.</p>
38
39
40
41
42
43
44
  <ul>
    <li>[[Improve documentation|contribute/how/documentation]]</li>
    <li>[[Write press releases|contribute/how/promote]]</li>
  </ul>
</div>
<div class="contribute-role" id="translator">
  <h3>Translator</h3>
Tails developers's avatar
Tails developers committed
45
  [[!img translator.png link=no]]
46
  <p>Translators can allow more people around the world to use Tails.</p>
47
48
49
50
51
52
  <ul>
    <li>[[Improve Tails in your own language|contribute/how/translate]]</li>
  </ul>
</div>
<div class="contribute-role" id="speaker">
  <h3>Speaker</h3>
Tails developers's avatar
Tails developers committed
53
  [[!img speaker.png link=no]]
54
  <p>Speakers can advocate Tails to all kinds of public.</p>
55
56
57
58
59
60
61
  <ul>
    <li>[[Talk at events|contribute/how/promote]]</li>
  </ul>
</div>
</div>

<div class="contribute-roles-3">
62
<h2>Contribute your computer skills</h2>
63
<div class="contribute-role" id="developer">
Tails developers's avatar
Tails developers committed
64
  <h3>Developer or maintainer</h3>
Tails developers's avatar
Tails developers committed
65
  [[!img software_developer.png link=no]]
66
  <p>Software people with very diverse skills can improve Tails.</p>
67
  <ul>
68
    <li>[[Work on the source code|contribute/how/code]]</li>
69
    <li>[[Improve Tails by working on Debian|contribute/how/debian]]</li>
70
71
72
73
  </ul>
</div>
<div class="contribute-role" id="sysadmin">
  <h3>System administrator</h3>
Tails developers's avatar
Tails developers committed
74
  [[!img system_administrator.png link=no]]
75
  <p>System administrators can contribute to the infrastructure behind Tails.</p>
76
  <ul>
77
78
    <li>[[Run a HTTP mirror|contribute/how/mirror]]</li>
    <li>[[Improve Tails infrastructure|contribute/how/sysadmin]]</li>
79
80
81
82
  </ul>
</div>
<div class="contribute-role" id="designer">
  <h3>Designer</h3>
Tails developers's avatar
Tails developers committed
83
  [[!img designer.png link=no]]
84
  <p>Designers can make Tails easier to use and more appealing.</p>
85
86
  <ul>
    <li>[[Improve the website|contribute/how/website]]</li>
Tails developers's avatar
Tails developers committed
87
    <li>[[Design graphics|contribute/how/graphics]]</li>
88
    <li>[[Improve the Tails user experience|contribute/how/user_experience]]</li>
89
90
91
  </ul>
</div>
</div>
92

93
94
95
96
97
<div class="toc">

	<h1>Table of contents</h1>

	<ol>
Tails developers's avatar
Tails developers committed
98
99
		<li class="L2"><a href="#reference-documents">Reference documents</a></li>
		<li class="L2"><a href="#tools">Tools for contributors</a></li>
sajolida's avatar
sajolida committed
100
		<li class="L2"><a href="#mentors">Mentors & guidance for new contributors</a></li>
Tails developers's avatar
Tails developers committed
101
102
103
		<li class="L2"><a href="#release-cycle">Release cycle</a></li>
		<li class="L2"><a href="#upstream">Relationship with upstream</a></li>
		<li class="L2"><a href="#collective-process">Collective process</a></li>
104
105
106
107
108
		<li class="L2"><a href="#talk">Talk with us</a></li>
	</ol>

</div> <!-- .toc -->

109
<div class="note">
110

Tails developers's avatar
Tails developers committed
111
This section is only in English, because there is currently no way to
112
contribute to Tails if you do not understand English.
113

114
</div>
115

Tails developers's avatar
Tails developers committed
116
117
<a id="reference-documents"></a>

118
119
120
Reference documents
===================

sajolida's avatar
sajolida committed
121
  - [[Mission and values|contribute/mission]]
122
  - [[Design documents|contribute/design]]
123
  - [[Blueprints|blueprint]] to help structuring ideas for future improvements
124
  - [[Merge policy|contribute/merge_policy]]
intrigeri's avatar
intrigeri committed
125
  - [[!tails_website contribute/how/promote/material/logo desc="Logo"]]
126
  - [[Personas|contribute/personas]]
127

Tails developers's avatar
Tails developers committed
128
129
<a id="tools"></a>

130
131
132
133
Tools for contributors
======================

  - Source code: [[Git repositories|contribute/git]]
134
  - [[!tails_roadmap desc="Roadmap"]]
135
  - [[Redmine bug tracker|contribute/working_together/Redmine]]
xin's avatar
xin committed
136
    - [[Starter tasks|starter_tasks]] for new contributors
137
    - [Tasks](https://redmine.tails.boum.org/code/projects/tails/issues)
138
      can be filtered by type of work (see links in the sidebar)
139
  - [[Building a Tails image|contribute/build]]
140
    - [[Build a local copy of the website|contribute/build/website]]
141
    - [[Customize Tails|contribute/customize]]
142
143
144
    - [Nightly ISO builds](http://nightly.tails.boum.org)
  - Debian packages
    - [[APT repository|contribute/APT_repository]], to store our custom Debian packages
145
    - How we manage and upgrade the [[Linux kernel|contribute/Linux_kernel]].
146
    - How we manage and upgrade [[contribute/tor]].
147
  - [[Glossary for contributors|contribute/glossary]]
148

149
150
151
<a id="mentors"></a>

Mentors & guidance for new contributors
Ulrike Uhlig's avatar
Ulrike Uhlig committed
152
=======================================
153

xin's avatar
xin committed
154
Once you have found a first [[Starter task|starter_tasks]] to work on,
sajolida's avatar
sajolida committed
155
you might need some guidance.
156

sajolida's avatar
Shorten  
sajolida committed
157
158
Here is a list of mentors who can help with
specific tasks. Feel free to talk to them if you plan to work on anything related to their
sajolida's avatar
sajolida committed
159
field of expertise, for example
sajolida's avatar
sajolida committed
160
by assigning them tickets on Redmine or <a href="#talk">talking to us</a>
161
using the usual communication channels.
162

Ulrike Uhlig's avatar
Ulrike Uhlig committed
163
  - AppArmor: intrigeri, jvoisin, u
anonym's avatar
anonym committed
164
  - Build system (Vagrant, Rake): anonym
165
  - Debian related work: intrigeri, u
sajolida's avatar
sajolida committed
166
  - Documentation: BitingBird, sajolida
167
168
  - *Onion Circuits* (Python): alan
  - *OpenPGP Applet* (Perl): nodens
sajolida's avatar
sajolida committed
169
  - Persistent Storage (Perl): intrigeri, kurono
170
  - Sysadmin: [[contact|contribute/how/sysadmin/#contact]]
171
  - Welcome Screen (Python): alan, intrigeri
172
173
174
175
  - *Tails Installer* (Python): alan, kurono, u
  - *Tails Upgrader* (Perl): intrigeri
  - *Tails Verification* (JavaScript): sajolida, anonym
  - Test suite (Gherkin, Ruby): anonym
anonym's avatar
anonym committed
176
  - *Thunderbird* (Icedove): anonym
sajolida's avatar
sajolida committed
177
  - Tor configuration, time syncing, MAC spoofing: anonym
anonym's avatar
anonym committed
178
  - *Tor Browser*: anonym
sajolida's avatar
sajolida committed
179
  - Usability: sajolida, tchou
anonym's avatar
anonym committed
180
  - *Unsafe Web Browser*: anonym
sajolida's avatar
sajolida committed
181
  - Website: sajolida
182
  - *WhisperBack* (Python): alan
183

Tails developers's avatar
Tails developers committed
184
185
<a id="release-cycle"></a>

186
187
188
189
190
Release cycle
=============

  - [[Release schedule|contribute/release_schedule]]
  - [[Release process|contribute/release_process]]
191
    - [[Manual test suite|contribute/release_process/test]]
192
    - [[Automated test suite|contribute/release_process/test/automated_tests]]
193

Tails developers's avatar
Tails developers committed
194
195
<a id="upstream"></a>

196
197
Relationship with upstream and derivatives
==========================================
198
199

  - [[Relationship with upstream|contribute/relationship_with_upstream]]
200
  - [[Improve Tails by working on Debian|contribute/how/debian]]
201
  - [[About creating Tails derivatives|contribute/derivatives]]
202

Tails developers's avatar
Tails developers committed
203
204
<a id="collective-process"></a>

205
206
207
Collective process
==================

Tails developers's avatar
Tails developers committed
208
  - [[Calendar|contribute/calendar]] of releases, meetings, working sessions, etc.
Tails developers's avatar
Tails developers committed
209
  - [[Code of conduct|contribute/working_together/code_of_conduct]]
210
  - [[Social contract|contribute/working_together/social_contract]]
211
  - [[Reimbursements for workers and regular contributors|contribute/reimbursements]]
212
  - [[Sponsorship to attend events|contribute/sponsorship_to_attend_events]]
213
  - [[Organizing a sprint|contribute/sprint]]
xin's avatar
xin committed
214
  - [[Marking a task as Starter|contribute/working_together/criteria_for_starter_tasks]]
215
  - [[Document progress|contribute/working_together/document_progress]]
sajolida's avatar
sajolida committed
216
  - Teams
sajolida's avatar
sajolida committed
217
    - [[Accounting and management team|contribute/working_together/roles/accounting]]
218
    - [[Foundations team|contribute/working_together/roles/foundations_team]]
219
    - [[Help desk|contribute/working_together/roles/help_desk]]
sajolida's avatar
sajolida committed
220
221
    - [[Release managers|contribute/working_together/roles/release_manager]]
    - [[Ticket gardeners|contribute/working_together/roles/ticket_gardener]]
sajolida's avatar
sajolida committed
222
    - [[Sysadmins|contribute/working_together/roles/sysadmins]]
sajolida's avatar
sajolida committed
223
    - [[Technical writers|contribute/working_together/roles/technical_writer]]
sajolida's avatar
sajolida committed
224
    - [[Test suite maintainers|contribute/working_together/roles/test_suite]]
225
    - [[Translation platform maintainers|contribute/working_together/roles/translation_platform]]
sajolida's avatar
sajolida committed
226
    - [[UX designers|contribute/working_together/roles/ux]]
227
228
    - [[Verification extension
      maintainers|contribute/working_together/roles/verification_extension]]
sajolida's avatar
sajolida committed
229
230
231
  - Roles for sponsor deliverables:
      - [[Team manager|contribute/working_together/roles/sponsor_deliverables/team_manager]]
      - [[Worker|contribute/working_together/roles/sponsor_deliverables/worker]]
sajolida's avatar
sajolida committed
232
  - [[Reports sent to sponsors|contribute/reports]]
233

Tails developers's avatar
Tails developers committed
234
235
<a id="talk"></a>

236
237
Talk with us
============
238

239
240
To talk to other Tails contributors, subscribe to
[[the relevant mailing lists|about/contact]].