diff options
Diffstat (limited to 'doc/khelpcenter/faq/contrib.docbook')
| -rw-r--r-- | doc/khelpcenter/faq/contrib.docbook | 163 |
1 files changed, 163 insertions, 0 deletions
diff --git a/doc/khelpcenter/faq/contrib.docbook b/doc/khelpcenter/faq/contrib.docbook new file mode 100644 index 000000000..6bb716f62 --- /dev/null +++ b/doc/khelpcenter/faq/contrib.docbook @@ -0,0 +1,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, ⪚ 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 (⪚ 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> + + |