|
1 | 1 | --- |
2 | | -title: Issues |
| 2 | +title: "Get Help" |
| 3 | +redirect_from: /issues/index.html |
3 | 4 | --- |
4 | 5 |
|
5 | | -__Have a problem or question? We are here to help - but you have to help us help you. |
6 | | -Here is what you need to do:__ |
| 6 | +* Table of Contents |
| 7 | +{:toc} |
| 8 | + |
| 9 | +<center> |
| 10 | +<strong>Have a problem or question?</strong> |
| 11 | +<br /><br /> |
| 12 | +<strong>We are here to help - but you have to help us help you.</strong> |
| 13 | +</center> |
| 14 | + |
| 15 | +GitHub Issues |
| 16 | +------------- |
| 17 | + |
| 18 | +We keep track of problems, suggestions and questions about ev3dev using [GitHub |
| 19 | +Issues]. This lets us keep everything in one place. (So, please don't email the |
| 20 | +developers directly unless you have a personal question.) |
7 | 21 |
|
8 | 22 | * First, before submitting an issue, please make sure that you have the latest |
9 | 23 | kernel and other packages: |
@@ -32,7 +46,7 @@ Here is what you need to do:__ |
32 | 46 | [issues][ev3dev-lang-issues]{:target="_blank"} tracker. |
33 | 47 |
|
34 | 48 | * If you don't find anything helpful by searching, then create a [new issue]{:target="_blank"} |
35 | | - (only one problem, question or suggestion per issue please). |
| 49 | + (only __one__ problem, question or suggestion per issue please). |
36 | 50 |
|
37 | 51 | __Most importantly for problems, we need to know the *exact* steps need to reproduce the |
38 | 52 | issue. If you are writing a program, post the code. If you are following |
@@ -74,7 +88,31 @@ Here is what you need to do:__ |
74 | 88 |
|
75 | 89 | * Learn more about [writing on GitHub]{:target="_blank"}. |
76 | 90 |
|
| 91 | +IRC |
| 92 | +--- |
| 93 | + |
| 94 | +IRC is [Internet Relay Chat]. You can find other ev3dev users in [#ev3dev on |
| 95 | +freenode.net]. It is a great way to ask quick questions or carry on a conversation. |
| 96 | + |
| 97 | +If you have never used IRC before, there are a some things you need to know: |
| 98 | + |
| 99 | +* We are a global community - not everyone lives in the same time zone. If you |
| 100 | + ask a question and no one answers, stay connected for a day or two and someone |
| 101 | + may eventually answer (or leave a note that you will check the logs - see below). |
| 102 | +* If no one ever answers you, do not be offended. The right person did not see |
| 103 | + your message, or maybe no one knows the answer. Ask again later or open a GitHub issue. |
| 104 | + |
| 105 | +Also, #ev3dev is logged by `ev3devlogbot`. You can find the logs at <http://ev3dev.org/irclog>. |
| 106 | + |
| 107 | +If you don't already have an IRC client program, you can connect right in your |
| 108 | +browser. Just enter a nickname and click start below. |
| 109 | + |
| 110 | +<iframe src="https://kiwiirc.com/client/irc.freenode.net/?&theme=cli#ev3dev" style="border:0; width:100%; height:450px;"></iframe> |
| 111 | + |
| 112 | +[GitHub Issues]: https://help.github.com/articles/about-issues/ |
77 | 113 | [ev3dev-lang]: https://github.com/ev3dev/ev3dev-lang |
78 | 114 | [ev3dev-lang-issues]: https://github.com/ev3dev/ev3dev-lang/issues |
79 | 115 | [new issue]: https://github.com/ev3dev/ev3dev/issues/new |
80 | 116 | [writing on GitHub]: https://help.github.com/categories/writing-on-github/ |
| 117 | +[Internet Relay Chat]: https://en.wikipedia.org/wiki/Internet_Relay_Chat |
| 118 | +[#ev3dev on freenode.net]: irc://irc.freenode.net/#ev3dev |
0 commit comments