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
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"><<a href="mailto:trinity-devel@lists.pearsoncomputing.net">trinity-devel@lists.pearsoncomputing.net</a>></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->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();
|
|
?>
|
|
|