You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

129 lines
8.5 KiB

<?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="/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="/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="/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();
?>