[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#608400: re-organize how to contribute documentation "per-profile"

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Here's a formatted version, in wml, of my draft for the new Intro/Help
page.

I've incorporated many of the items on the original page into my
revision, while keeping the structure that was mentioned earlier in
the bug report.

Feel free to give me suggestions on what to improve!


Thanks,

Sean
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJSxmZ5AAoJEC9ACRPRNMOU/aEH/2/QW3e3+Lnk6UcFHLDgqnrW
ELf8GPWW9fBdg4ysSt8E8tJ8Bdc5tqKMmX23FUdFGqOaoObYpR08gwIdbsKPAAt5
iKkO0nem10V4Fj4bDzRVIR3kIpUkDyXcT1oRwo+LDJvdleDivgEmZU2t+sy3LNO+
VYVgf4Fgh638qmuqvCynW7pbRt45sNoljKg51J9bgjTCHPbbLp2uDLhZ7fgzZjEh
1wwGWVpi+h5sR4/tpkfBu3k/4a5a4X4FSMzUzR4TrUTKyrThsl+WY17LJu03NqI8
xeBffhvH9uM6QTZDsgCkmMG92k4JQsnaI6bA/Twg18Y47LBzZHYmJdfXQJzLhg8=
=Eh6u
-----END PGP SIGNATURE-----
Title: Debian -- How can you help Debian?

How can you help Debian?

If you are considering helping in the development of Debian there are many areas in which both experienced and inexperienced users can assist. there are many ways you can get involved with the project and only few of them require you to be a Debian Developer. Many of the different projects have mechanisms to allow direct access to source code trees to contributors that have shown they are trustworthy and valuable. Typically, people which find that they can get much more involved in Debian will join the project, but this is not always required.

Finally, Debian provides many teams of developers working together on common tasks. Anybody can participate on a team, whether an official Debian Developer or not.

    Users & Developers

    Bug Triaging

    You can simply test the operating system and the programs provided in it and report any not yet known errata or bugs you find using the Bug Tracking System. Try to browse also the bugs associated with packages you use and provide further information, if you can reproduce the issues described in them.

    While handling bugs can be considered part of the maintainer's job, your triaging contributions are welcome! For an introduction on the important steps to report bugs in the Debian Bug Tracking System (BTS) and general bug reporting information, see these documents on the Wiki:

    Helpful bug documents worth reading are:

    Packaging

    You can help maintain applications that are already available in the Debian operating system, specially those you use much and know about, by contributing fixes (patches) or additional information in the Bug Tracking System for those packages. You can also get involved directly in package maintenance by becoming a member of a group maintenance team or get involved with software that is being developed for Debian by joining a software project at Alioth.

    You can help porting Debian to some architecture you are experienced with either by starting a new port or contributing to existing ports. For more information see the list of available ports.

    You can package applications you have much experience with and consider valuable for Debian and become the maintainer for those packages. For more information read the Debian Developer's Corner.

    You can help track, find and fix security issues within the packages in Debian.

    Web Development

    You can help with the development of the public face of Debian and contribute to the website or by helping with the organisation of events worldwide.

    Creative & Non-Developers

    Artwork

    DebianArt is a place for high quality artwork and themes for the Debian Desktop. The idea is use the website for contests, creating an archive of user contributed artwork that can be freely used and included in upcoming Debian releases.

    Documentation

    You can help writing documentation either by working with the official documentation provided by the Debian Documentation Project or by contributing at the Debian Wiki.

    Translation

    You can help translating applications or Debian-related information (web pages, documentation) to your own language by getting involved in a translation project (discussion is generally handled through the i18n mailing list). You can even start up a new internationalisation group if there is none for your language. For more information read the Internationalisation pages.

    Help translate the Debian website, documentation, po-debconf, Debian Project News (DPN) with these resources:

    Publicity/Events

    Help Debian promoting itself by talking about it and demonstrating it to others.

    User Support

    You can also provide support if you're an experienced user by helping others on the Debian Mailing Lists and IRC Channels.

    Donations

    You can donate equipment and services to the Debian project so that either its users or developers can benefit from them. We are in constant search for mirrors worldwide our users can rely on and auto-builder systems for our porters.

As you can see, there are many ways you can get involved with the project and only few of them require you to be a Debian Developer. Many of the different projects have mechanisms to allow direct access to source code trees to contributors that have shown they are trustworthy and valuable. Typically, people which find that they can get much more involved in Debian will join the project, but this is not always required.

#use wml::debian::template title="How can you help Debian?"

<p> If you are considering helping in the development of Debian there are many areas in which both experienced and inexperienced users can assist. 
there are many ways you can get involved with the project and only few of them require you to be a Debian Developer. 
Many of the different projects have mechanisms to allow direct access to source code trees to contributors that have shown they are trustworthy and valuable. 
Typically, people which find that they can get much more involved in Debian will <a href="http://www.debian.org/devel/join/";>join the project</a>, but this is not always required.
</p>

<p> Finally, Debian provides many <a href="https://wiki.debian.org/Teams";>teams</a> of developers working together on common tasks. Anybody can participate on a team, whether an official Debian Developer or not.
</p>


# TBD - Describe requirements per task?
# such as: knowledge of english, experience in area X, etc..

<ol>

<h2> Users & Developers </h2>


<h3> Bug Triaging </h3>
<p>You can simply test the operating system and the programs provided in it
and report any not yet known errata or bugs you find using the 
<a href="http://bugs.debian.org/";>Bug Tracking System</a>.  Try to browse also
the bugs associated with packages you use and provide further
information, if you can reproduce the issues described in them.</p>

<p>	While handling bugs can be considered part of the maintainer's job, your triaging contributions are welcome!
	For an introduction on the important steps to report bugs in the Debian Bug Tracking System (BTS) and general bug reporting information, see these documents on the Wiki:
</p>
<ul>
	<li> <a href="http://www.debian.org/Bugs";> Bugs </a> </li>
	<li> <a href="http://wiki.debian.org/BugTriage";> Bug Triage </a> </li>
</ul>

<p> Helpful bug documents worth reading are:
<ul>
	<li> <a href="http://wiki.debian.org/HowtoUseBTS";>How to use the Bug Tracking System</a> </li>
	<li> <a href="http://wiki.debian.org/BugsVersionTracking";>Bugs Version Tracking</a>, about how the BTS treat the version informations. </li>
	<li> Finally don't hesitate to refer to the <a href="http://www.debian.org/Bugs/server-control";>BTS documentation</a> whenever you need to write to control@bugs.debian.org! </li>
</ul>



<h3> Packaging </h3>

<p>You can help maintain applications that are already available in the Debian
operating system, specially those you use much and know about, by
contributing fixes (patches) or additional information in the <a
href="http://bugs.debian.org/";>Bug Tracking System</a> for those packages.  You
can also get involved directly in package maintenance by becoming a member of a
group maintenance team or get involved with software that is being developed
for Debian by joining a software project at <a
href="http://alioth.debian.org/";>Alioth</a>.</p>

<p>You can help porting Debian to some architecture you are experienced with
either by starting a new port or contributing to existing ports.  For more
information see the <a href="$(HOME)/ports/">list of available ports</a>.</p>

<p>You can package applications you have much experience with and consider
valuable for Debian and become the maintainer for those packages.  For more
information read the <a href="$(HOME)/devel/">Debian Developer's Corner</a>.</p>

<p>You can help <a href="http://security-tracker.debian.org/tracker/data/report";>track</a>,
<a href="$(HOME)/security/audit/">find</a> and 
<a href="$(DOC)/manuals/developers-reference/pkgs.html#bug-security">fix</a>
<a href="$(HOME)/security/">security issues</a> within the packages in Debian.
</p>

<ul>
	<li> Help packaging new applications and maintaining orphaned packages: <a href="http://www.debian.org/devel/wnpp/";>WNPP</a></li>
	<li> Help <a href="http://wiki.debian.org/Teams";>teams</a></li>
	<li> Debian <a href="http:/www.debian.org/ports/">ports</a></li>
</ul>



<h3> Web Development </h3>

<p>You can help with the development of the <em>public</em> face of Debian and
contribute to the <a href="$(HOME)/devel/website/">website</a> or by 
helping with the organisation of <a href="$(HOME)/events/">events</a>
worldwide.</p>

<ul>
	<li>Helping with the Debian <a href="http://www.debian.org/devel/website/";>website</a></li>
	<li>Recommended reading: <a href="http://www.debian.org/devel/website/desc";>How debian.org is made</a> </li>
</ul>




<h2> Creative & Non-Developers </h2>


<h3> Artwork </h3>

DebianArt is a place for high quality artwork and themes for the Debian Desktop. 
The idea is use the website for contests, creating an archive of user contributed artwork that can be freely used and included in upcoming Debian releases. 

<ul>
	<li> Design new themes at <a href="http://wiki.debian.org/DebianArt";>DebianArt</a></li>
	<li> Help in the maintainence of the <a href="https://wiki.debian.org/Fonts/TODO";>fonts</a></li>
</ul>


<h3> Documentation </h3>

<p>You can help writing documentation either by working with the official
documentation provided by the <a href="$(HOME)/doc/ddp">Debian Documentation
Project</a> or by contributing at the <a href="http://wiki.debian.org/";>Debian
Wiki</a>.</p>

<ul>
	<li> Write manuals/howto/FAQ at the <a href="http://www.debian.org/doc/ddp";>Debian Documentation Project</a></li>
	<li> Help the Doc <a href="http://www.debian.org/doc/todo";>Team</a></li>
	<li> Write <a href="http://lintian.debian.org/tags/binary-without-manpage.html";>Manpages</a></li>
	<li> Contribute to the the <a href="http://wiki.debian.org/Teams/DebianWiki";>Debian Wiki</a></li>
</ul>


<h3> Translation </h3>

# TBD - link to translators mailing lists
# Translators, link directly to your group's pages
<p>You can help translating applications or Debian-related information
(web pages, documentation) to your own language by
getting involved in a translation project (discussion is generally handled
through the <a href="http://lists.debian.org/debian-i18n/";>i18n mailing list</a>).
You can even
start up a new internationalisation group if there is none for your
language.  For more information read the <a
href="$(HOME)/international/">Internationalisation pages</a>.</p>

<p> Help translate the Debian website, documentation, po-debconf, Debian Project News (DPN) with these resources: </p>


<ul>
	<li> <a href="http://wiki.debian.org/Teams/I18n";>Internationalization Team</a></li>
	<li> Debian <a href="http://www.debian.org/international/";>Debian International</a></li>
	<li> <a href="http://wiki.debian.org/L10n";>Localization</a></li>
</ul>



<h3> Publicity/Events </h3>

<p>Help Debian promoting itself by talking about it and demonstrating it to others.</p>

<ul>
	<li> Help in writing/reviewing news for the <a href="http://wiki.debian.org/ProjectNews/HowToContribute/";>Debian Project News (DPN)</a></li>
	<li> Debian <a href="http://wiki.debian.org/Promote";>promotion</a></li>
	<li> Attend Debian <a href="http://wiki.debian.org/DebianEvents";>Events</a></li>
	<li> <a href="http://www.debian.org/events";>Organize</a> a Debian event</li> 
</ul>


<h3> User Support </h3>

<p> You can also provide support if you're an experienced user by helping others on the Debian Mailing Lists and IRC Channels.</p>

<ul>
	<li><a href="http://lists.debian.org/completeindex.html";>Debian Mailing Lists</a></li>
	<li><a href="http://wiki.debian.org/IRC";>IRC</a></li>
</ul>


<h3> Donations </h3>

<p>You can <a href="$(HOME)/donations">donate equipment and services</a> to the Debian project so that 
either its users or developers can benefit from them.  We are in constant search
for <a href="$(HOME)/mirror/">mirrors worldwide</a> our users can rely on and
<a href="$(HOME)/devel/buildd/">auto-builder systems</a> for our porters.</p>

<ul>
	<li><a href="http://www.debian.org/donations";>Donations</a></li>
	<li> Become a <a href="http://www.debian.org/partners/partners";>partner</a></li>
</ul>


</ol>

<p>As you can see, there are many ways you can get involved with the project
and only few of them require you to be a Debian Developer.  Many of the
different projects have mechanisms to allow direct access to source code trees
to contributors that have shown they are trustworthy and valuable.  Typically,
people which find that they can get much more involved in Debian will <a
href="$(HOME)/devel/join">join the project</a>, but this is not 
always required.</p>

# <p>Related links:
Reply to: