aboutsummaryrefslogtreecommitdiffstats
path: root/english/support.wml
diff options
context:
space:
mode:
authorHeike Jurzik <post@heikejurzik.de>2022-05-04 16:48:28 +0200
committerThomas Lange <lange@debian.org>2022-05-20 20:54:07 +0200
commit2b215c6e7169b28ab15c0eb330ed620ef7b21647 (patch)
tree7d102882b680e211785a6b82841dccaae4c16d14 /english/support.wml
parentb401d47a6f1f894f14566f34e37c9972494b5084 (diff)
Minor layout changes, adds links to Wiki (IRC), moves paragraph on consultants to aside note at the top
Diffstat (limited to 'english/support.wml')
-rw-r--r--english/support.wml203
1 files changed, 96 insertions, 107 deletions
diff --git a/english/support.wml b/english/support.wml
index 4316ea199c2..92368daf4c8 100644
--- a/english/support.wml
+++ b/english/support.wml
@@ -1,44 +1,62 @@
-#use wml::debian::template title="Support"
-#use wml::debian::toc
+#use wml::debian::template title="User Support" MAINPAGE="true"
+#use wml::debian::recent_list
-<define-tag toc-title-formatting endtag="required" whitespace="delete">
-<h2>%body</h2>
-</define-tag>
+<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css">
-Debian and its support are run by a community of volunteers.
-If this community-driven support doesn't fulfil your needs, you may
-read our <a href="doc/">documentation</a> or
-hire a <a href="consultants/">consultant</a>.
+<ul class="toc">
+ <li><a href="#irc">IRC (real time Support)</a></li>
+ <li><a href="#mail_lists">Mailing Lists</a></li>
+ <li><a href="#usenet">Usenet Newsgroups</a></li>
+ <li><a href="#forums">Debian User Forums</a></li>
+ <li><a href="#maintainers">How to contact Package Maintainers</a></li>
+ <li><a href="#bts">Bug Tracking System</a></li>
+ <li><a href="#release">Known Problems</a></li>
+</ul>
-<toc-display />
+<aside>
+<p><span class="fas fa-caret-right fa-3x"></span> Debian support is offered by a group of volunteers. If this community-driven support doesn't fulfil your needs and you can't find the answer in our <a href="doc/">documentation</a>, you may hire a <a href="consultants/">consultant</a> to maintain or add additional functionality your Debian system.</p>
+</aside>
-<toc-add-entry name="irc">On-line Real Time Help Using IRC</toc-add-entry>
+<h2><a id="irc">IRC (real time Support)</a></h2>
-<p><a href="http://www.irchelp.org/">IRC (Internet Relay Chat)</a> is a way
-to chat with people from all over the world in real time.
-IRC channels dedicated to Debian can be found on
-<a href="https://www.oftc.net/">OFTC</a>.</p>
+<p>
+<a href="http://www.irchelp.org/">IRC</a> (Internet Relay Chat) is a great way to chat with people from all over the world in real time. It's a text-based chat system for instant messaging. On IRC you can enter chat rooms (so-called channels) or you can directly chat with individual persons via private messages.
+</p>
+
+<p>
+IRC channels dedicated to Debian can be found on <a href="https://www.oftc.net/">OFTC</a>. For a full list of Debian channels, please refer to our <a href="https://wiki.debian.org/IRC">Wiki</a>. You can also use a <a href="https://netsplit.de/channels/index.en.php?net=oftc&chat=debian">search engine</a> to check for Debian-related channels.
+</p>
+
+<h3>IRC Clients</h3>
-<p>To connect, you need an IRC client. Some of the most popular clients are
-<a href="https://packages.debian.org/stable/net/hexchat">HexChat</a>,
-<a href="https://packages.debian.org/stable/net/ircii">ircII</a>,
-<a href="https://packages.debian.org/stable/net/irssi">irssi</a>,
-<a href="https://packages.debian.org/stable/net/epic5">epic5</a> and
-<a href="https://packages.debian.org/stable/net/kvirc">KVIrc</a>,
-all of which have been packaged for
-Debian. OFTC also offers a <a href="https://www.oftc.net/WebChat/">WebChat</a>
-web interface which allows you to connect to IRC with a browser without
-the need to install any local client.</p>
+<p>
+To connect to the IRC network, you can either use OFTC's <a href="https://www.oftc.net/WebChat/">WebChat</a> in your preferred web browser or install a client on your computer. There are lots of different clients out there, some with a graphical interface, some for the console. Some popular IRC clients have been packaged for Debian, for example:
+</p>
+
+<ul>
+ <li><a href="https://packages.debian.org/stable/net/irssi">irssi</a> (text mode)</li>
+ <li><a href="https://packages.debian.org/stable/net/weechat-curses">WeeChat</a> (text mode)</li>
+ <li><a href="https://packages.debian.org/stable/net/hexchat">HexChat (GTK)</a></li>
+ <li><a href="https://packages.debian.org/stable/net/konversation">Konversation</a> (KDE)</li>
+</ul>
+
+<p>
+The Debian Wiki offers a more comprehensive <a href="https://wiki.debian.org/IrcClients">list of IRC clients</a> which are available as Debian packages.
+</p>
-<p>Once you have the client installed, you need to tell it to connect
-to the server. In most clients, you can do that by typing:</p>
+<h3>Connect to the Network</h3>
+
+<p>
+Once you have the client installed, you need to tell it to connect
+to the server. In most clients, you can do that by typing:
+</p>
<pre>
/server irc.debian.org
</pre>
-<p>In some clients (such as irssi) you will need to type this instead:</p>
+<p>The hostname irc.debian.org is an alias for irc.oftc.net. In some clients (such as irssi) you will need to type this instead:</p>
<pre>
/connect irc.debian.org
@@ -52,66 +70,46 @@ to the server. In most clients, you can do that by typing:</p>
# for support in your language.
# <p>For support in English, read on</p>
-<p>Once you are connected, join channel <code>#debian</code> by typing</p>
+<h3>Join a Channel</h3>
+
+<p>Once you are connected, join channel <code>#debian</code> by typing this command:</p>
<pre>
/join #debian
</pre>
-<p>Note: clients like HexChat often have a different, graphical user interface
-for joining servers/channels.</p>
-
-<p>At this point you will find yourself among the friendly crowd of
-<code>#debian</code> inhabitants. You're welcome to ask questions about
-Debian there. You can find the channel's faq at
-<url "https://wiki.debian.org/DebianIRC" />.</p>
-
-
-<p>There's a number of other IRC networks where you can chat about Debian,
-too.</p>
-
+<p>Note: graphical clients like HexChat or Konversation often have a button
+or a menu entry for connecting to servers and joining channels.
+</p>
-<toc-add-entry name="mail_lists" href="MailingLists/">Mailing lists</toc-add-entry>
+<p style="text-align:center"><button type="button"><span class="fas fa-book-open fa-2x"></span> <a href="https://wiki.debian.org/DebianIRC">Read our IRC FAQ</a></button></p>
-<p>Debian is developed through distributed development all around
-the world. Therefore e-mail is a preferred way to discuss various items.
-Much of the conversation between Debian developers and users is managed
-through several mailing lists.</p>
+<h2><a id="mail_lists">Mailing Lists</a></h2>
-<p>There are several publicly available mailing lists. For more information,
-see <a href="MailingLists/">Debian mailing lists</a> page.</p>
+<p>
+More than thousand active <a href="intro/people.en.html#devcont">developers</a> spread around the world work on Debian in their spare timeā€”and in their own timezones. Therefore we communicate primarily through e-mail. Similarly, most of the conversation between Debian developers and users happens on different <a href="MailingLists/">mailing lists</a>:
+</p>
# Note to translators:
# You might want to adapt the following paragraph, stating which list
# is available for user support in your language instead of English.
-<p>
-For user support in English, please contact the
-<a href="https://lists.debian.org/debian-user/">debian-user
-mailing list</a>.
-</p>
+
+<ul>
+ <li>For user support in English, please contact the <a href="https://lists.debian.org/debian-user/">debian-user</a> mailing list.</li>
+ <li>For user support in other languages, please check the <a href="https://lists.debian.org/users.html">index</a> of other user mailing lists.</li>
+</ul>
<p>
-For user support in other languages, please check the
-<a href="https://lists.debian.org/users.html">mailing
-lists index for users</a>.
+Of course, there are plenty of other mailing lists, dedicated to some aspect of the Linux ecosystem and not Debian-specific. Please use your favorite search engine to find the most suitable list for your purpose.
</p>
-<p>There are of course many other mailing lists, dedicated to some aspect
-of the vast Linux ecosystem, which are not Debian-specific. Use your
-favorite search engine to find the most suitable list for your purpose.</p>
-
-
-<toc-add-entry name="usenet">Usenet newsgroups</toc-add-entry>
-
-<p>A lot of our <a href="#mail_lists">mailing lists</a> can be browsed as
-newsgroups, in the <kbd>linux.debian.*</kbd> hierarchy. This can also be
-done using a web interface such as
-<a href="https://groups.google.com/forum/">Google Groups</a>.
+<h2><a id="usenet">Usenet Newsgroups</a></h2>
+<p>
+A lot of our <a href="#mail_lists">mailing lists</a> can be browsed as newsgroups, in the <kbd>linux.debian.*</kbd> hierarchy. For easy access to the newsgroups, you can use a web interface such as <a href="https://groups.google.com/forum/">Google Groups</a>.
+</p>
-<toc-add-entry name="web">Web sites</toc-add-entry>
-
-<h3 id="forums">Forums</h3>
+<h2><a id="forums">Debian User Forums</h2>
# Note to translators:
# If there is a specific Debian forum for your language you might want to
@@ -125,38 +123,25 @@ done using a web interface such as
# on which you can use the English language to discuss Debian-related topics,
# submit questions about Debian, and have them answered by other users.</p>
-<p><a href="https://forums.debian.net">Debian User Forums</a> is a web portal on which
-you can discuss Debian-related topics, submit questions about Debian, and have
-them answered by other users.</p>
-
-
-<toc-add-entry name="maintainers">Reaching Package Maintainers</toc-add-entry>
-
-<p>There are two ways of reaching package maintainers. If you need to
-contact the maintainer because of a bug, simply file a bug report (see the
-Bug Tracking System section below). The maintainer will get a copy of the
-bug report.</p>
-
-<p>If you simply want to communicate with the maintainer, then you can use
-the special mail aliases set up for each package. Any mail sent to
-&lt;<em>package name</em>&gt;@packages.debian.org will be forwarded to the
-maintainer responsible for that package.</p>
-
-
-<toc-add-entry name="bts" href="Bugs/">The Bug Tracking System</toc-add-entry>
-
-<p>The Debian distribution has a bug tracking system which
-details bugs reported by users and developers. Each bug is given a
-number, and is kept on file until it is marked as having been dealt
-with.</p>
+<p>
+<a href="https://forums.debian.net">Debian User Forums</a> is a web portal
+where thousands of other users discuss Debian-related topics, ask questions,
+and help each other by answering them. You can read all boards without
+having to register. If you want to participate in the discussion and publish
+your own postings, please register and log in.
+</p>
-<p>To report a bug, you can read the bug page below; we recommend the
-use of the Debian package <q>reportbug</q> to automatically file a bug report.</p>
+<h2><a id="maintainers">How to contact Package Maintainers</a></h2>
-<p>Information on submitting bugs, viewing the currently active bugs, and
-the bug tracking system in general can be found at the
-<a href="Bugs/">bug tracking system web pages</a>.</p>
+<p>
+Basically, there are two common ways to get in touch with a maintainer of a Debian package:
+</p>
+<ul>
+ <li>If you'd like to report a bug, simply file a <a href="bts">bug report</a>; the maintainer automatically receives a copy of your bug report.</li>
+ <li>If you simply want to send an email to the maintainer, use the special mail aliases set up for each package:<br>
+ &lt;<em>package_name</em>&gt;@packages.debian.org</li>
+</ul>
<toc-add-entry name="doc" href="doc/">Documentation</toc-add-entry>
@@ -173,17 +158,21 @@ Debian FAQ, and other users' and developers' manuals.</p>
<toc-add-entry name="consultants" href="consultants/">Consultants</toc-add-entry>
-<p>Debian is free software and offers free help through mailing lists. Some
-people either don't have the time or have specialized needs and are willing
-to hire someone to maintain or add additional functionality to their Debian
-system. See the <a href="consultants/">consultants page</a> for a list
-of people/companies.</p>
+<h2><a id="bts">Bug Tracking System</a></h2>
+
+<p>
+The Debian distribution has its own <a href="Bugs/">bug tracker</a> with bugs reported by users and developers. Every bug has a unique number and is kept on file until it is marked as resolved. There are two different ways to report a bug:
+</p>
+<ul>
+ <li>The recommended way is to use the Debian package <em>reportbug</em>.</li>
+ <li>Alternatively, you can send an email as described on this <a href="Bugs/Reporting">page</a>.</li>
+</ul>
-<toc-add-entry name="release" href="releases/stable/">Known problems</toc-add-entry>
+<h2><a id="release">Known Problems</a></h2>
<p>Limitations and severe problems of the current stable distribution
-(if any) are described on <a href="releases/stable/">the release pages</a>.</p>
+(if any) are described on <a href="releases/stable/">the release page</a>.</p>
-<p>Pay particular attention to the <a href="releases/stable/releasenotes">release
+<p>Please pay particular attention to the <a href="releases/stable/releasenotes">release
notes</a> and the <a href="releases/stable/errata">errata</a>.</p>

© 2014-2024 Faster IT GmbH | imprint | privacy policy