The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Difference between revisions of "Getting Help"
(Added rough draft for the Getting Help page. Needs to be properly formatted and the links inlined.) |
|||
| Line 17: | Line 17: | ||
Simply enter funtoo under the channel name and choose your nickname! | Simply enter funtoo under the channel name and choose your nickname! | ||
Often times, if you're | Often times, if you're experiencing build failures, users on the chat will want you to share more information | ||
about your system. Your Funtoo install is quite unique and fine-tuned to your system, and users | about your system. Your Funtoo install is quite unique and fine-tuned to your system, and users | ||
will have a hard time figuring out your problem without additional information. This is your chance to be vocal about your problem, we generally don't mind the chatter as long as it helps in resolving the problem. However, to share emerge info, and build log information on irc use {{package|app-text/wgetpaste}}. Share links wgetpaste returns to you, rather than posting directly to the channel. | will have a hard time figuring out your problem without additional information. This is your chance to be vocal about your problem, we generally don't mind the chatter as long as it helps in resolving the problem. However, to share emerge info, and build log information on irc use {{package|app-text/wgetpaste}}. Share links wgetpaste returns to you, rather than posting directly to the channel. | ||
Generally, if you describe your problem well, you can expect to get quite a swift response. If not, the developers will probably catch your issue when they review the chat for news and will contact you | Generally, if you describe your problem well, you can expect to get quite a swift response. If not, the developers will probably catch your issue when they review the chat for news and will contact you | ||
to assist you with resolving your issue. Try to stick around, we can generally resolve the issue quite quickly. | to assist you with resolving your issue. Try to stick around, we can generally resolve the issue quite quickly. | ||
== Support Forums == | == Support Forums == | ||
Revision as of 21:27, February 6, 2017
Introduction
This document was written to centralize the various resources available to you as a Funtoo user to fix problems you may encounter. While encountering build failures, bugs or other glitches may be frustrating, Funtoo provides powerful tools and a friendly community that should make resolving such issues a breeze.
Getting (almost) immediate help - IRC
The #funtoo IRC channel on freenode (irc.freenode.net) is available for informal, real-time technical support and troubleshooting. Please use Funtoo channels rather than Gentoo channels for Funtoo Linux support.
Patience is advised if you're experiencing an issue. Users might not share the same time zone as you do, and they might be at work or occupied otherwise when you ask your question, so stick around. That doesn't mean we as a community aren't glad to help! Quite the contrary, we'd like to hear from you, so drop in and join us on the chat even before you start experiencing issues!
You can use the net-irc/irssi IRC client to access the #funtoo IRC channel. Alternatively,
you can use the browser based chat available through the freenode webchat: https://webchat.freenode.net/
Simply enter funtoo under the channel name and choose your nickname!
Often times, if you're experiencing build failures, users on the chat will want you to share more information about your system. Your Funtoo install is quite unique and fine-tuned to your system, and users will have a hard time figuring out your problem without additional information. This is your chance to be vocal about your problem, we generally don't mind the chatter as long as it helps in resolving the problem. However, to share emerge info, and build log information on irc use app-text/wgetpaste. Share links wgetpaste returns to you, rather than posting directly to the channel.
Generally, if you describe your problem well, you can expect to get quite a swift response. If not, the developers will probably catch your issue when they review the chat for news and will contact you to assist you with resolving your issue. Try to stick around, we can generally resolve the issue quite quickly.
Support Forums
The support forums are also available to discuss issues and also improvements. To access the Forums, the Wiki and the Bugtracker you'll need to register for an account here: http://auth.funtoo.org:9093/new
The following Web-based discussion resources are specifically created for community-based support and troubleshooting, and are monitored by the Funtoo Linux core team. Under the new thread text area, attach the emerge info, and build logs directly to your posts rather than using wgetpaste links. Wgetpaste links expire where the forums attached files are timeless.
Reporting bugs directly
You can also use the JIRA bug tracker to find if your issue has already been fixed, or to report a new issue. The bugtracker is reviewed by the Funtoo Linux core team on a regular basis. However, to get the swiftest response, please follow the instructions on http://www.funtoo.org/Reporting_Bugs . The guidelines ensure that the core team has enough information to reproduce and fix your issue.
Read the news!
You might have missed the news items listed on the main page, but you should definitely check them out! They contain important information on possible issues while upgrading Funtoo, and also information about new features. Breaking changes and difficult upgrades tend to be well documented in the news, and also on the Forums under the News and Announcements section.