summaryrefslogtreecommitdiffstats
path: root/doc/khelpcenter/faq/contrib.docbook
blob: 6bb716f62729152b7e4646e6d3281c42e875089e (plain)
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
157
158
159
160
161
162
163
<!--
<?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd">
-->


<chapter id="contribute">
<title>Contributing</title>

<qandaset>
<qandaentry>
<question>
<para>How can I contribute to &tde;?</para>
</question>
<answer>
<para>&tde; is a free/libre software project that lives from voluntary
contributions. Everybody is encouraged to contribute to &tde;. Not
only programmers are welcome. There are many ways in which you can
help to improve &tde;:</para>
<itemizedlist>
<listitem><para>Test the software.</para></listitem>
<listitem><para>Send in bug reports. For more information,
refer to <link linkend="bug-report">How do I submit a bug
report?</link>.</para></listitem>
<listitem><para>Write or edit documentation and help files.</para></listitem>
<listitem><para>Translate programs, documentation, and help files.
</para></listitem>
<listitem><para>Draw icons, wallpaper, or compose sound effects.</para></listitem>
<listitem><para>Write articles and books about &tde;. If you want to
help spread the word about &tde;, send an email to
<email>trinity-devel@lists.pearsoncomputing.net</email>. This will get you in touch
with the &tde; developers and packagers.</para></listitem>
<listitem><para>Program new &tde; applications. Please refer to <xref
linkend="programming"/> for more information.</para></listitem>
<listitem><para> Of course, sponsors are also
welcome. :-)</para></listitem>
</itemizedlist>
<para>There are several places to look for more information if you
want to get involved in the development. The first step is to
subscribe to some of the <ulink  url="http://www.trinitydesktop.org/mailinglist.php">mailing
lists</ulink>. You will soon see something
that can be improved or added.</para>
</answer>
</qandaentry>

<qandaentry>
<question id="bug-report">
<para>How do I submit a bug report?</para>
</question>
<answer>
<para>There is a bug tracking system available at <ulink
url="http://bugs.trinitydesktop.org/">http://bugs.trinitydesktop.org/</ulink>
and thanks for helping! The system features several query types and a
list of all known bugs.</para>
<para>The easiest way to submit a bug is to select
<menuchoice><guimenu>Help</guimenu><guimenuitem>Report
Bug/Request Enhancement...</guimenuitem></menuchoice> from the menu bar of the application
with the bug. This will open a dialog box with a link
to the bug tracking system. Please follow the
instructions of the bug reporting wizard.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>May I join the development team?</para>
</question>
<answer>
<para>Please! Join our discussion list at
<ulink url="http://www.trinitydesktop.org/mailinglist.php">
http://www.trinitydesktop.org/mailinglist.php</ulink>. Join
Internet Relay Chat (IRC) sessions at chat.freenode.net, channel: #trinity-desktop</para>
</answer>
</qandaentry>

<qandaentry>
<question id="programming">
<para>I want to program for &tde;. What should I do first?</para>
</question>
<answer>
<para>Everybody is encouraged to develop software for &tde;. What you
should do first depends strongly on your experience, &eg; whether you have
already learned C++ or have experience with the &Qt; toolkit and so
on.</para>
<para>To get into &tde; programming, you will need some basic tools:
<application>automake</application>,
<application>autoconf</application>, and
<application>cmake</application>.</para>
<para>An excellent resource for learning &tde;
programming is the &Qt; tutorials. These are installed along with &Qt;. To view them,
open <filename>$<envar>TQTDIR</envar>/doc/html/index.html</filename> in
&konqueror; and bookmark the locatio. The tutorials
can be found under "Using Qt". The source code for each lesson can be found in the <filename
class="directory">$<envar>TQTDIR</envar>/tutorial</filename>
directory.</para>
<para>There is one thing everybody interested in
programming for &tde; should do: please <emphasis>subscribe to the developers
mailing list</emphasis>. To subscribe, you have to send an email to
<ulink
url="mailto:trinity-devel-subscribe@lists.pearsoncomputing.net">trinity-devel-subscribe@lists.pearsoncomputing.net</ulink>
with an empty email.
<important><para>Please read<ulink url="http://www.trinitydesktop.org/mailinglist.php">
http://www.trinitydesktop.org/mailinglist.php</ulink>. Everything
written there applies to the development list as well.</para></important></para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How do I get access to &tde; <acronym>GIT</acronym>?</para>
</question>
<answer>
<para>The &tde; project uses <acronym>GIT</acronym> to develop the
core parts of the software. Usually, when you have changed one of the
parts (&eg; fixed a bug), and you want to commit this change, the best
way is to create a patch against a current snapshot and send this
patch to the developer/maintainer of the respective program.</para>
<para>If you are doing this more or less regularly, then contact the developers
to obtain write access to the <acronym>GIT</acronym> repository:
<ulink url="trinity-devel@lists.pearsoncomputing.net">
trinity-devel@lists.pearsoncomputing.net</ulink>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>Can I have read-only access to the <acronym>GIT</acronym> repository?</para>
</question>
<answer>
<para>Yes. Instructions on how to get anonymous, read-only <acronym>GIT</acronym>
access are here: <ulink url="http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT">
http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT</ulink>
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>Are there any <acronym>GIT</acronym> mirror sites for &tde;?</para>
</question>
<answer>
<para>No, currently there are no anonymous <acronym>GIT</acronym> mirror sites for &tde;.
</para>
</answer>
</qandaentry>

<!--<qandaentry>
<question>
<para>How do I go about translating &tde; programs into my native
language?</para>
</question>
<answer>
<para>Look at the <ulink url="http://i18n.kde.org">The &tde;
Translators' and Documenters' Web Site</ulink> to see whether your
program is already translated (most are). Otherwise you will find
information there on how to do it yourself.</para>
</answer>
</qandaentry>-->
</qandaset>
</chapter>