Signed-off-by: Andrew "Tianon" Page <admwiggin@gmail.com>
Tianon Gravi authored on 2015/01/03 15:42:451 | 1 |
new file mode 100644 |
... | ... |
@@ -0,0 +1,37 @@ |
0 |
+# Freenode IRC Administration Guidelines and Tips |
|
1 |
+ |
|
2 |
+This is not meant to be a general "Here's how to IRC" document, so if you're |
|
3 |
+looking for that, check Google instead. ♥ |
|
4 |
+ |
|
5 |
+If you've been charged with helping maintain one of Docker's now many IRC |
|
6 |
+channels, this might turn out to be useful. If there's information that you |
|
7 |
+wish you'd known about how a particular channel is organized, you should add |
|
8 |
+deets here! :) |
|
9 |
+ |
|
10 |
+## `ChanServ` |
|
11 |
+ |
|
12 |
+Most channel maintenance happens by talking to Freenode's `ChanServ` bot. For |
|
13 |
+example, `/msg ChanServ ACCESS <channel> LIST` will show you a list of everyone |
|
14 |
+with "access" privileges for a particular channel. |
|
15 |
+ |
|
16 |
+A similar command is used to give someone a particular access level. For |
|
17 |
+example, to add a new maintainer to the `#docker-maintainers` access list so |
|
18 |
+that they can contribute to the dicsussions (after they've been merged |
|
19 |
+appropriately in a `MAINTAINERS` file, of course), one would use `/msg ChanServ |
|
20 |
+ACCESS #docker-maintainers ADD <nick> maintainer`. |
|
21 |
+ |
|
22 |
+To setup a new channel with a similar `maintainer` access template, use a |
|
23 |
+command like `/msg ChanServ TEMPLATE <channel> maintainer +AV` (`+A` for letting |
|
24 |
+them view the `ACCESS LIST`, `+V` for auto-voice; see `/msg ChanServ HELP FLAGS` |
|
25 |
+for more details). |
|
26 |
+ |
|
27 |
+## Troubleshooting |
|
28 |
+ |
|
29 |
+The most common cause of not-getting-auto-`+v` woes is people not being |
|
30 |
+`IDENTIFY`ed with `NickServ` (or their current nickname not being `GROUP`ed with |
|
31 |
+their main nickname) -- often manifested by `ChanServ` responding to an `ACCESS |
|
32 |
+ADD` request with something like `xyz is not registered.`. |
|
33 |
+ |
|
34 |
+This is easily fixed by doing `/msg NickServ IDENTIFY OldNick SecretPassword` |
|
35 |
+followed by `/msg NickServ GROUP` to group the two nicknames together. See |
|
36 |
+`/msg NickServ HELP GROUP` for more information. |