diff options
author | Heike Jurzik <post@heikejurzik.de> | 2022-05-04 16:48:28 +0200 |
---|---|---|
committer | Thomas Lange <lange@debian.org> | 2022-05-20 20:54:07 +0200 |
commit | 2b215c6e7169b28ab15c0eb330ed620ef7b21647 (patch) | |
tree | 7d102882b680e211785a6b82841dccaae4c16d14 /english/support.wml | |
parent | b401d47a6f1f894f14566f34e37c9972494b5084 (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.wml | 203 |
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 -<<em>package name</em>>@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> + <<em>package_name</em>>@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> |