Asking Questions: Difference between revisions
m (l18n bar) |
(IRC -> libera chat) |
||
(53 intermediate revisions by 16 users not shown) | |||
Line 1: | Line 1: | ||
<languages /> | |||
__TOC__ | |||
<translate> | |||
==Using IRC to get help== <!--T:2--> | |||
Here are a few tips on asking questions, especially in #kde on | <!--T:3--> | ||
Here are a few tips on asking questions, especially in #kde on Libera Chat, in a way that is more likely to get answers: | |||
* '''Don | <!--T:4--> | ||
* '''Don't ask to ask, just ask''': the irc.libera.chat channel #kde is a user support channel, so we expect your questions - go right ahead {{smiley}}. | |||
* '''Be ready with | <!--T:5--> | ||
* '''Be ready with as much relevant details about your system as you can find''': Questions you are likely to be asked are:</translate> | |||
<translate> | |||
<!--T:53--> | |||
** What distribution do you use (and what version?) e.g. Kubuntu 18.04</translate> | |||
<translate> | |||
<!--T:54--> | |||
** what version of Plasma you are running — if you don't know, open '''Konsole''' and type <code>plasmashell --version</code> and look at the version number given there</translate> | |||
<translate> | |||
<!--T:55--> | |||
** how you installed it — mostly likely from your distribution repositories. | |||
<!--T:48--> | |||
You probably won't need to give all of this information straight away, but if you know how to find it quickly it often helps | |||
* ''' | <!--T:6--> | ||
* '''Try to do some troubleshooting yourself before asking''': Google is your friend (entering error messages into Google often finds something useful). You should also take a look at [[Special:myLanguage/Troubleshooting|Troubleshooting KDE Problems]] - the advice there is probably what you'll be told in #kde anyway, so try it first {{smiley}} | |||
* ''' | <!--T:7--> | ||
* '''Also, try to make sure that the problem you're having is a problem with KDE software''' and not some other component of your system (for example, a problem with [http://en.wikipedia.org/wiki/X_Window_System X] or with [http://en.wikipedia.org/wiki/Advanced_Linux_Sound_Architecture ALSA]). If possible, try an alternative, non-KDE application to see whether the problem also occurs there. Of course, if you're not sure, please ask. | |||
* ''' | <!--T:8--> | ||
* '''Use [http://forum.kde.org/ the Forum]'''. Try asking a question on [http://forum.kde.org/ the forum]. If the discussion brings up interesting information you might add it to UserBase, so that it can help others. | |||
* ''' | <!--T:9--> | ||
* '''Be prepared to wait!''' Often on IRC, someone will notice your question a little while after you ask it, so wait around for a while after you ask. There's nothing more annoying than typing out a long answer for someone, only to realise that they left 3 minutes after asking their question! In some cases there could be hours between your question being asked and someone who knows the answer coming on-line (remember that KDE users are all over the world) so sometimes you just have to ask again at a different time of day. | |||
<!--T:10--> | |||
* '''If you don't get an answer on #kde, you can also try the channel for your distribution''' (eg, #suse, #kde-freebsd, etc), or an appropriate mailing list: see [http://lists.kde.org lists.kde.org] or forum. | |||
<!--T:11--> | |||
* '''Above all, be patient and polite.''' Remember that the people who help are all volunteers, and could be spending their time doing other things than helping. | * '''Above all, be patient and polite.''' Remember that the people who help are all volunteers, and could be spending their time doing other things than helping. | ||
If your problem is with sound in KDE, you might want to first | <!--T:12--> | ||
If your problem is with sound, you might want to first read [[Special:myLanguage/Sound_Problems|Sound Problems]]. | |||
<!--T:13--> | |||
If your question relates to development, please see [http://techbase.kde.org/Contribute KDE TechBase's contribute page] | |||
<!--T:49--> | |||
Because KDE is so actively developed, changes arrive very frequently, so don't be surprised if you can't find any written information. Ask in IRC, the Forum or a mailing list, and when you have an answer, register an account on UserBase and add the information to the relevant page. At the same time as learning about your system you will be helping others do the same {{smiley}} | |||
== The Forums == <!--T:44--> | |||
<!--T:45--> | |||
Another great place to get help is the [http://forum.kde.org/ KDE Community Forums]. It is always a good idea to search the forums first. Maybe your question has already been answered. If not, find an appropriate forum and start a thread. Don't expect an immediate answer, but remember to come back regularly to participate in the discussion as it gets going. Remember that the forums are run by users like yourself. | |||
<!--T:50--> | |||
The KDE Community forums offer a "guided post" feature that can help you post your question in the appropriate forum, increasing the chance of having it seen by people knowledgeable on the matter. It is accessible as a large "New Post" button on the forums' homepage, so if you have any doubts, that is the place to start. | |||
<!--T:51--> | |||
The forums have an extensive search feature: prior to posting try finding if your question has already been answered, or there are hints that might help you solve your issue. If there is no satisfactory solution for your problem, make a new post. To search, enter keywords in the upper right box of any forum page. By default this will search the whole forums. For extended searches, click on the "Search" link under the "KDE Community Forums" banner. | |||
<!--T:52--> | |||
If your question has been properly answered, consider marking a topic as "solved". It is a very little step, but quite helpful for other users and staff, because it tells them that there are no more issues. To mark a topic as solved, choose the topic with the best answer in the thread, and click the green tick mark under it. If you go back to the topic list you will notice a green tick mark next to the topic's title as well. | |||
<!--T:46--> | |||
Most distributions have forums of their own; these can also be valuable. The web pages of your distribution should provide links to its forums. | |||
==Operating-System-Specific Questions== <!--T:14--> | |||
<!--T:15--> | |||
For questions relating to the desktop use of Plasma with a particular operating system (OS), you can try the above methods, but unless the question directly involves KDE software or KDE/GNU/Linux you are unlikely to find the answer. ''If your question does not directly involve KDE, please do not post the question on the "normal" KDE mailing lists''. An example of questions that do not directly involve KDE is "''my sound card does not work''". In that case, please direct your questions at sites devoted to helping users of that system. For example, for GNU/Linux questions you may try looking at [http://www.linuxnewbie.org www.linuxnewbie.org] or [http://www.linuxnewbie.com www.linuxnewbie.com], or the [http://mail.kde.org/mailman/listinfo/kde-linux kde-linux] mailing list mentioned above. | |||
<!--T:28--> | |||
If you are not using GNU/Linux, you might want to try the [http://mail.kde.org/mailman/listinfo/kde-nonlinux kde-nonlinux] [mailto:kde-nonlinux-subscribe@kde.org?subject=subscribe (subscribe)] mailing list. Also particularly useful are searches on your favorite search engine, such as [http://www.google.com/ Google], and searches on the [http://groups.google.com/ Usenet archives]. | |||
<!--T:16--> | |||
In addition, many OS distributors have their own mailing lists which can address distribution-specific issues. You can find out more about these mailing lists at your distribution's website or find them through your browser search engine. | |||
<!--T:17--> | |||
If you are searching for packages you may consider checking the ftp servers for your distribution, including the "contrib" sections, as well as indexing servers such as rpmfind.net. Wherever possible, install the package that your distro offers directly through its package manager. | |||
</translate><span id="Reporting KDE Bugs"></span><translate> | |||
==Reporting KDE Bugs== <!--T:18--> | |||
<!--T:30--> | |||
Reporting bugs is a small but valuable contribution to KDE, and there's a website where you can report any bug or feature request you have about KDE: [http://bugs.kde.org/ bugs.kde.org]. The only requirement on your side is basic knowledge of English. With that, and following some additional guidelines, you'll be able to report helpful bug reports and thus help the whole KDE community and yourself. | |||
<!--T:31--> | |||
The first thing you need is to open an account in the website. You can start [https://bugs.kde.org/createaccount.cgi here]. Once you have a validated account, you can report. | |||
<!--T:32--> | |||
There are usually two different situations to report a bug: | |||
<!--T:33--> | |||
* You notice something which is not working properly or not working at all, a bad design, a missed functionality... If this is your case, open the application <menuchoice>Help -> Report Bug...</menuchoice> menu. You will then be guided to [http://bugs.kde.org bugs.kde.org]. Some information will be automatically picked up, like the application version number. | |||
<!--T:34--> | |||
* Your program disappears and another window appears named "The KDE crash Handler". Don't get scared! You will be guided to efficiently report this crash. The link in the dialog "Learn more about bug reporting" will explain you the process. If you choose to report the problem, click on <menuchoice>Report Bug</menuchoice> and an assistant will guide you through the steps. The requisite to report a crash is to have your distribution debug packages installed in order to provide a valid backtrace. | |||
<!--T:35--> | |||
And these are a few tips on how to write good bug reports: | |||
<!--T:36--> | |||
* Write it in English. You can switch every KDE application language through <menuchoice>Help -> Switch Application Language...</menuchoice>, so go there and choose American English as the primary language. Then restart the application. That can help you in explaining what happens. | |||
<!--T:37--> | |||
* Be specific. One bug per report only! Do not mix different problems in the same report. | |||
<!--T:38--> | |||
* Be clear. Explain the steps that lead to the bug so that we can reproduce them easily. | |||
<!--T:39--> | |||
* Include screenshots: a picture is worth many words so attach a screenshot to the bug report. You can use [[Special:mylanguage/KSnapshot|KSnapshot]] to take screenshots. Also, do not link to an external web link which can expire, use the Attachments link at the bottom of the bug report. | |||
<!--T:40--> | |||
* Include the backtrace within the bug report as a comment, it makes it easier to find duplicates for us (do not attach the backtrace as a text file). | |||
<!--T:41--> | |||
* Clearly separate facts from speculation: only describe what happens. For a design problem, include a mock-up if possible. | |||
<!--T:42--> | |||
If you are testing trunk or the beta, if you kept your precedent settings, sometimes you will want to check with a new user. | |||
<!--T:43--> | |||
Also notice that [http://forums.kde.org Forums] have a [http://forum.kde.org/viewforum.php?f=201 section about Beta Releases]. | |||
<!--T:47--> | |||
A good guide to bug reporting can be found [http://blogs.fsfe.org/myriam/2011/10/when-is-a-bug-report-useful/ here].</translate> | |||
---- | |||
<translate><!--T:21--> | |||
'''How to open a console''' | '''How to open a console''' | ||
Typically when reporting a problem in IRC or on a mailing list, your helpers will ask you to open a console. A console is a text-based window that you can use to give commands for your computer to execute. You can open a console by typing | <!--T:22--> | ||
Typically when reporting a problem in IRC or on a mailing list, your helpers will ask you to open a console. A console is a text-based window that you can use to give commands for your computer to execute. You can open a console by typing <keycap>Alt + Space</keycap>. An input box called '''Krunner''' opens. Type the following to open a console:</translate> | |||
{{input|1=konsole}} | |||
<translate><!--T:24--> | |||
If this does not work, you may not have it installed. In this case, type <keycap>Alt + F2</keycap> and input:</translate> | |||
{{input|1=xterm}} | |||
{|style="text-align:right" | |||
|'''<translate><!--T:29--> | |||
Back to [[Special:myLanguage/Getting_Help|Getting_Help]]</translate>''' | |||
|} | |||
< | <translate><!--T:27--> | ||
[[Category:Getting Started]] | |||
</translate> |
Latest revision as of 13:28, 16 July 2021
Using IRC to get help
Here are a few tips on asking questions, especially in #kde on Libera Chat, in a way that is more likely to get answers:
- Don't ask to ask, just ask: the irc.libera.chat channel #kde is a user support channel, so we expect your questions - go right ahead .
- Be ready with as much relevant details about your system as you can find: Questions you are likely to be asked are:
- What distribution do you use (and what version?) e.g. Kubuntu 18.04
- what version of Plasma you are running — if you don't know, open Konsole and type
plasmashell --version
and look at the version number given there - how you installed it — mostly likely from your distribution repositories.
You probably won't need to give all of this information straight away, but if you know how to find it quickly it often helps
- Try to do some troubleshooting yourself before asking: Google is your friend (entering error messages into Google often finds something useful). You should also take a look at Troubleshooting KDE Problems - the advice there is probably what you'll be told in #kde anyway, so try it first
- Also, try to make sure that the problem you're having is a problem with KDE software and not some other component of your system (for example, a problem with X or with ALSA). If possible, try an alternative, non-KDE application to see whether the problem also occurs there. Of course, if you're not sure, please ask.
- Use the Forum. Try asking a question on the forum. If the discussion brings up interesting information you might add it to UserBase, so that it can help others.
- Be prepared to wait! Often on IRC, someone will notice your question a little while after you ask it, so wait around for a while after you ask. There's nothing more annoying than typing out a long answer for someone, only to realise that they left 3 minutes after asking their question! In some cases there could be hours between your question being asked and someone who knows the answer coming on-line (remember that KDE users are all over the world) so sometimes you just have to ask again at a different time of day.
- If you don't get an answer on #kde, you can also try the channel for your distribution (eg, #suse, #kde-freebsd, etc), or an appropriate mailing list: see lists.kde.org or forum.
- Above all, be patient and polite. Remember that the people who help are all volunteers, and could be spending their time doing other things than helping.
If your problem is with sound, you might want to first read Sound Problems.
If your question relates to development, please see KDE TechBase's contribute page
Because KDE is so actively developed, changes arrive very frequently, so don't be surprised if you can't find any written information. Ask in IRC, the Forum or a mailing list, and when you have an answer, register an account on UserBase and add the information to the relevant page. At the same time as learning about your system you will be helping others do the same
The Forums
Another great place to get help is the KDE Community Forums. It is always a good idea to search the forums first. Maybe your question has already been answered. If not, find an appropriate forum and start a thread. Don't expect an immediate answer, but remember to come back regularly to participate in the discussion as it gets going. Remember that the forums are run by users like yourself.
The KDE Community forums offer a "guided post" feature that can help you post your question in the appropriate forum, increasing the chance of having it seen by people knowledgeable on the matter. It is accessible as a large "New Post" button on the forums' homepage, so if you have any doubts, that is the place to start.
The forums have an extensive search feature: prior to posting try finding if your question has already been answered, or there are hints that might help you solve your issue. If there is no satisfactory solution for your problem, make a new post. To search, enter keywords in the upper right box of any forum page. By default this will search the whole forums. For extended searches, click on the "Search" link under the "KDE Community Forums" banner.
If your question has been properly answered, consider marking a topic as "solved". It is a very little step, but quite helpful for other users and staff, because it tells them that there are no more issues. To mark a topic as solved, choose the topic with the best answer in the thread, and click the green tick mark under it. If you go back to the topic list you will notice a green tick mark next to the topic's title as well.
Most distributions have forums of their own; these can also be valuable. The web pages of your distribution should provide links to its forums.
Operating-System-Specific Questions
For questions relating to the desktop use of Plasma with a particular operating system (OS), you can try the above methods, but unless the question directly involves KDE software or KDE/GNU/Linux you are unlikely to find the answer. If your question does not directly involve KDE, please do not post the question on the "normal" KDE mailing lists. An example of questions that do not directly involve KDE is "my sound card does not work". In that case, please direct your questions at sites devoted to helping users of that system. For example, for GNU/Linux questions you may try looking at www.linuxnewbie.org or www.linuxnewbie.com, or the kde-linux mailing list mentioned above.
If you are not using GNU/Linux, you might want to try the kde-nonlinux (subscribe) mailing list. Also particularly useful are searches on your favorite search engine, such as Google, and searches on the Usenet archives.
In addition, many OS distributors have their own mailing lists which can address distribution-specific issues. You can find out more about these mailing lists at your distribution's website or find them through your browser search engine.
If you are searching for packages you may consider checking the ftp servers for your distribution, including the "contrib" sections, as well as indexing servers such as rpmfind.net. Wherever possible, install the package that your distro offers directly through its package manager.
Reporting KDE Bugs
Reporting bugs is a small but valuable contribution to KDE, and there's a website where you can report any bug or feature request you have about KDE: bugs.kde.org. The only requirement on your side is basic knowledge of English. With that, and following some additional guidelines, you'll be able to report helpful bug reports and thus help the whole KDE community and yourself.
The first thing you need is to open an account in the website. You can start here. Once you have a validated account, you can report.
There are usually two different situations to report a bug:
- You notice something which is not working properly or not working at all, a bad design, a missed functionality... If this is your case, open the application bugs.kde.org. Some information will be automatically picked up, like the application version number. menu. You will then be guided to
- Your program disappears and another window appears named "The KDE crash Handler". Don't get scared! You will be guided to efficiently report this crash. The link in the dialog "Learn more about bug reporting" will explain you the process. If you choose to report the problem, click on and an assistant will guide you through the steps. The requisite to report a crash is to have your distribution debug packages installed in order to provide a valid backtrace.
And these are a few tips on how to write good bug reports:
- Write it in English. You can switch every KDE application language through , so go there and choose American English as the primary language. Then restart the application. That can help you in explaining what happens.
- Be specific. One bug per report only! Do not mix different problems in the same report.
- Be clear. Explain the steps that lead to the bug so that we can reproduce them easily.
- Include screenshots: a picture is worth many words so attach a screenshot to the bug report. You can use KSnapshot to take screenshots. Also, do not link to an external web link which can expire, use the Attachments link at the bottom of the bug report.
- Include the backtrace within the bug report as a comment, it makes it easier to find duplicates for us (do not attach the backtrace as a text file).
- Clearly separate facts from speculation: only describe what happens. For a design problem, include a mock-up if possible.
If you are testing trunk or the beta, if you kept your precedent settings, sometimes you will want to check with a new user.
Also notice that Forums have a section about Beta Releases.
A good guide to bug reporting can be found here.
How to open a console
Typically when reporting a problem in IRC or on a mailing list, your helpers will ask you to open a console. A console is a text-based window that you can use to give commands for your computer to execute. You can open a console by typing Alt + Space. An input box called Krunner opens. Type the following to open a console:
konsole
If this does not work, you may not have it installed. In this case, type Alt + F2 and input:
xterm
Back to Getting_Help |