diff options
Diffstat (limited to 'faq/contribute.php')
| -rw-r--r-- | faq/contribute.php | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/faq/contribute.php b/faq/contribute.php new file mode 100644 index 0000000..0a0ed47 --- /dev/null +++ b/faq/contribute.php @@ -0,0 +1,128 @@ +<?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="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->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="http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT" target="_top"> + +http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT</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>No, currently there are no anonymous GIT mirror sites for TDE. + +</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(); +?> + |