Difference between revisions of "Getting Help"

From Funtoo
Jump to navigation Jump to search
(Added rough draft for the Getting Help page. Needs to be properly formatted and the links inlined.)
 
(8 intermediate revisions by 4 users not shown)
Line 6: Line 6:
be frustrating, Funtoo provides powerful tools and a friendly community that should make resolving such issues a breeze.
be frustrating, Funtoo provides powerful tools and a friendly community that should make resolving such issues a breeze.


== Getting (almost) immediate help - IRC ==
== Getting Immediate Help ==


The {{c|#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.
Join the official Funtoo Discord or Telegram channels for online real-time chat:


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.  
* [https://discord.gg/BNUSpUU Funtoo Linux Discord (English)]
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! 
* [https://t.me/funtoolinux Funtoo Linux Telegram (English/Portuguese)]
 
You can use the {{package|net-irc/irssi}} IRC client to access the {{c|#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 experincing 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 {{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
to assist you with resolving your issue. Try to stick around, we can generally resolve the issue quite quickly.


== Support Forums ==
== Support Forums ==


The support forums are also available to discuss issues and also improvements. To access the 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 Wiki, and the bug tracker you'll need to register for an account [https://auth.funtoo.org/new here].


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.  
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 while the forums attached files are timeless.


* [http://forums.funtoo.org/forum/7-installation-help/ Installation Help]
* [http://forums.funtoo.org/forum/7-installation-help/ Installation Help]
Line 38: Line 27:
== Reporting bugs directly ==
== 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.
You can also visit [https://bugs.funtoo.org Funtoo bug tracker] to find out 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 available [http://www.funtoo.org/Reporting_Bugs here]. The guidelines ensure that the core team has enough information to reproduce and fix your 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! ==
== Read the news! ==


You might have missed the news items listed on the main page, but you should definitely check them out!
You might have missed the [http://www.funtoo.org/index.php?title=Special:ViewData&tables=news%2Cpeople&fields=news._pageName%2Cnews.Publication_Date%2Cnews.News_Category%2Cnews.Summary%2Cnews.Author%2Cpeople.Gravatar_MD5%2Cnews.Icon%2Cnews.News_Format&where=news.Publication_Status%3D%22Published%22&join_on=news.Author%3Dpeople._pageName&order_by=cargo__news.Publication_Date+DESC&format=template&offset=2&limit=100&template=NewsDisplay 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.
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 [http://forums.funtoo.org/forum/5-news-and-announcements/ News and Announcements section].
 
http://www.funtoo.org/index.php?title=Special:ViewData&tables=news%2Cpeople&fields=news._pageName%2Cnews.Publication_Date%2Cnews.News_Category%2Cnews.Summary%2Cnews.Author%2Cpeople.Gravatar_MD5%2Cnews.Icon%2Cnews.News_Format&where=news.Publication_Status%3D%22Published%22&join_on=news.Author%3Dpeople._pageName&order_by=cargo__news.Publication_Date+DESC&format=template&offset=2&limit=100&template=NewsDisplay

Revision as of 05:07, October 16, 2019

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 Immediate Help

Join the official Funtoo Discord or Telegram channels for online real-time chat:

Support Forums

The support forums are also available to discuss issues and also improvements. To access the Forums, the Wiki, and the bug tracker you'll need to register for an account here.

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 while the forums attached files are timeless.

Reporting bugs directly

You can also visit Funtoo bug tracker to find out 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 available here. 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.