<?php
    include("../tde-head-and-foot.php");
    doHeader("Contributing", "Documentation", "FAQ", "../");
?>
<STYLE>
    .question {font-weight:bold;}
    TD {padding-top:10px}
</STYLE>
<table width="100%" class="header"><tbody><tr><td align="left" class="navLeft" width="33%"><a accesskey="p" href="questions.php">Prev</a></td><td align="center" class="navCenter" width="34%"></td><td align="right" class="navRight" width="33%">

		      <a accesskey="n" href="credits.php">Next</a></td></tr></tbody></table>
<p class="chapter" lang="en">
<p class="titlepage">
<p>
<p><h2 class="title"><a name="contribute"></a>Chapter 19. Contributing</h2>
<p class="qandaset"><dl><dt>19.1. <a href="contribute.php#idm140487996923568">How can I contribute to TDE?</a></dt><dt>19.2. <a href="contribute.php#idm140487996832816">How do I submit a bug report?</a></dt><dt>19.3. <a href="contribute.php#idm140487996827392">May I join the development team?</a></dt><dt>19.4. <a href="contribute.php#idm140487996824032">I want to program for TDE. What should I do first?</a></dt><dt>19.5. <a href="contribute.php#idm140487996808128">How do I get access to TDE GIT?</a></dt><dt>19.6. <a href="contribute.php#idm140487996801168">Can I have read-only access to the GIT repository?</a></dt><dt>19.7. <a href="contribute.php#idm140487996796880">Are there any GIT mirror sites for TDE?</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="idm140487996923568"></a><a name="idm140487996923248"></a><b>19.1.</b></td><td align="left" valign="top"><p>How can I contribute to TDE?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>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:</p>
<p class="itemizedlist"><ul type="disc"><li><p>Test the software.</p></li><li><p>Send in bug reports. For more information,

refer to <a href="contribute.php#bug-report">How do I submit a bug

report?</a>.</p></li><li><p>Write or edit documentation and help files.</p></li><li><p>Translate programs, documentation, and help files.

</p></li><li><p>Draw icons, wallpaper, or compose sound effects.</p></li><li><p>Write articles and books about TDE. If you want to

help spread the word about TDE, send an email to

<code class="email">&lt;<a href="mailto:trinity-devel@lists.pearsoncomputing.net">trinity-devel@lists.pearsoncomputing.net</a>&gt;</code>. This will get you in touch

with the TDE developers and packagers.</p></li><li><p>Program new TDE applications. Please refer to <a href="contribute.php#programming">Q:19.4</a> for more information.</p></li><li><p> Of course, sponsors are also

welcome. :-)</p></li></ul><p>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 <a href="http://www.trinitydesktop.org/mailinglist.php" target="_top">mailing

lists</a>. You will soon see something

that can be improved or added.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996832816"></a><a name="bug-report"></a><b>19.2.</b></td><td align="left" valign="top"><p>How do I submit a bug report?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>There is a bug tracking system available at <a href="http://bugs.pearsoncomputing.net/" target="_top">http://bugs.pearsoncomputing.net/</a>

and thanks for helping! The system features several query types and a

list of all known bugs.</p><p>The easiest way to submit a bug is to select

Help-&gt;Report

Bug/Request Enhancement... 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.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996827392"></a><a name="idm140487996827072"></a><b>19.3.</b></td><td align="left" valign="top"><p>May I join the development team?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>Please! Join our discussion list at

<a href="http://www.trinitydesktop.org/mailinglist.php" target="_top">

http://www.trinitydesktop.org/mailinglist.php</a>. Join

Internet Relay Chat (IRC) sessions at chat.freenode.net, channel: #trinity-desktop</p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996824032"></a><a name="programming"></a><b>19.4.</b></td><td align="left" valign="top"><p>I want to program for TDE. What should I do first?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>Everybody is encouraged to develop software for TDE. What you

should do first depends strongly on your experience, e.g. whether you have

already learned C++ or have experience with the Qt toolkit and so

on.</p><p>To get into TDE programming, you will need some basic tools:

automake,

autoconf, and

cmake.</p><p>An excellent resource for learning TDE

programming is the Qt tutorials. These are installed along with Qt. To view them,

open <code class="filename">$<code class="envar">QTDIR</code>/doc/html/index.php</code> 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 <code class="filename">$<code class="envar">QTDIR</code>/tutorial</code>

directory.</p><p>There is one thing everybody interested in

programming for TDE should do: please <em>subscribe to the developers

mailing list</em>. To subscribe, you have to send an email to

<a href="mailto:trinity-devel-subscribe@lists.pearsoncomputing.net" target="_top">trinity-devel-subscribe@lists.pearsoncomputing.net</a>

with an empty email.


<p class="important" ><h3 class="title">Important</h3><p>Please read<a href="http://www.trinitydesktop.org/mailinglist.php" target="_top">

http://www.trinitydesktop.org/mailinglist.php</a>. Everything

written there applies to the development list as well.</p></p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996808128"></a><a name="idm140487996807808"></a><b>19.5.</b></td><td align="left" valign="top"><p>How do I get access to TDE GIT?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>The TDE project uses GIT to develop the

core parts of the software. Usually, when you have changed one of the

parts (e.g. 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.</p><p>If you are doing this more or less regularly, then contact the developers

to obtain write access to the GIT repository:

<a href="trinity-devel@lists.pearsoncomputing.net" target="_top">

trinity-devel@lists.pearsoncomputing.net</a>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996801168"></a><a name="idm140487996800848"></a><b>19.6.</b></td><td align="left" valign="top"><p>Can I have read-only access to the GIT repository?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>Yes. Instructions on how to get anonymous, read-only GIT

access are here: <a href="https://wiki.trinitydesktop.org/Project_GIT_Information" target="_top">

https://wiki.trinitydesktop.org/Project_GIT_Information</a>

</p></td></tr><tr class="question"><td align="left" valign="top"><a name="idm140487996796880"></a><a name="idm140487996796560"></a><b>19.7.</b></td><td align="left" valign="top"><p>Are there any GIT mirror sites for TDE?</p></td></tr><tr class="answer"><td align="left" valign="top"><b></b></td><td align="left" valign="top"><p>Yes, an anonymous GIT mirror with CGIT interface is available at <a href="http://mirror.git.trinitydesktop.org/cgit">http://mirror.git.trinitydesktop.org/cgit</a>.

</p></td></tr></tbody></table><table width="100%" class="bottom-nav"><tr><td width="33%" align="left" valign="top" class="navLeft"><a href="questions.php">Prev</a></td><td width="34%" align="center" valign="top" class="navCenter"><a href="index.php">Home</a></td><td width="33%" align="right" valign="top" class="navRight"><a href="credits.php">Next</a></td></tr><tr><td width="33%" align="left" class="navLeft">Asking Questions</td><td width="34%" align="center" class="navCenter"><a href="index.php">Up</a></td><td width="33%" align="right" class="navRight">Credits and License</td></tr></table>
<?php
    doFooter();
?>

