Difference between revisions of "IRC"
(I've removed the botsmack command. I'm not comfortable with what it represents.) |
m (→Reminderbot: Updating Time::ParseDate URL to the version in use by Fig.) |
||
Line 311: | Line 311: | ||
This command does not need to be addressed directly to the bot. | This command does not need to be addressed directly to the bot. | ||
− | The reminderbot uses time formats as seen in http://search.cpan.org/~muir/Time-modules- | + | The reminderbot uses time formats as seen in http://search.cpan.org/~muir/Time-modules-2011.0517/lib/Time/ParseDate.pm - lettered time zones are case-sensitive and must be uppercase. |
When specifying a time for the bot to remind you, the bot will probably use today or tomorrow (if that time has already passed today) in the bot's time zone. If you are in a different time zone than the bot, you might want to specify the date some of the time. | When specifying a time for the bot to remind you, the bot will probably use today or tomorrow (if that time has already passed today) in the bot's time zone. If you are in a different time zone than the bot, you might want to specify the date some of the time. |
Revision as of 15:51, 1 September 2012
IRC stands for Internet Relay Chat, and is one of the oldest methods for group chat on the internet. Dreamwidth owners, contractors, developers/volunteers, users, and other interested parties occupy a number of IRC channels on the Freenode IRC network.
If you are a Dreamwidth user new to IRC, this page and the IRC help page have information on getting connected and set up. For one-on-one help, try asking in dw_volunteers. IRC is not required for volunteering, but can be very helpful and is where a great deal of social interaction takes place.
If you are a Freenode/FLOSS user new to Dreamwidth, welcome! You can find out more about the project on this wiki, in the development information, on the website itself (Diversity Statement, Guiding Principles), and in the site FAQs.
Contents
Quick Reference
- The server is:
chat.freenode.net
; more info on Freenode servers - The main channel is:
#dreamwidth
- The developer mentoring channel is:
#dreamwidth-dev
(merged into the main developer channel) - If you need more information on how this all works, see IRC help.
- The IRC quote database.
- IRC Icons
- No idea what people in IRC are saying? Common Jargon!
If you don't want to install an IRC client, Freenode does offer webchat:
Connecting to IRC
If you're new to IRC, check out IRC help for more details.
Put the server (irc.freenode.net) and the channel (#dreamwidth) into your favorite IRC client. Pick a nickname to be known by in channel. This doesn't have to be the same as your Dreamwidth username, but it does have to be a nickname that no one else on Freenode is using.
Registering your nickname
It's generally best if you register your nickname once you've settled on one that is available and you like. Some IRC features require this. (If your preferred nickname has already been registered, you can sometimes get staff to assist you in registering it.)
In order to register your nickname on the IRC channel, use this command:
/msg nickserv register [PASSWORD] [EMAIL]
You will receive an email shortly with instructions. (Do not include the square brackets in the command.)
You can then identify yourself to the IRC server with this command:
/msg nickserv identify [PASSWORD]
(Do not actually use the brackets, just put in your password or email.)
Using your nickname
If for some reason you can't identify to the server in time, or otherwise need to change your nickname, these commands will work:
/msg nickserv identify USERNAME PASSWORD /msg nickserv release USERNAME /nick USERNAME
Culture
The owners (mark/@xb95 and denise/@rahaeli) are the final arbiters of any IRC policy, issue, or debate.
Hazards
Hazards of hanging out in #dreamwidth include:
- becoming hungry from all the talk of delicious food
- starting to volunteer
- putting more time in developing, providing answers in support, doing a code tour, etc.
- becoming a project lead
- buying more yarn or other fiber arts supplies
- getting sucked into TVTropes, Wikipedia, and similar timesinks
- getting earwormed (see also earwormhole)
- pun wars
- conversations that started out perfectly rational and innocent degenerating (sometimes rapidly)
- losing the game
Rules
Official Rules coming eventually. In general:
- For the owners' peace of mind, no politics or religion (mentioning religion is fine; debating religious beliefs is not) in #dreamwidth.
- Don't be a jerk.
- Mind what the channel operators say. (Anyone with an '@dreamwidth/delegate/' hostmask has the potential to become an op, whether or not they are wearing their ops power at the time; there are a few others.)
- Please do not automatically post full channel logs publicly. There is a quotes database (log in using LJ or DW username), and use discretion if selecting sections to post elsewhere.
- Some general guidelines are included below, although this is not intended to be a complete list, and ops will use their best judgment regarding specific situations.
- fu (Afuna), denise (rahaeli), and mark (xb95) have the final say.
Consider the Diversity Statement and the Guiding Principles and try to embody them. denise in dw_volunteers: a few words about IRC
Specific things that come up from time to time:
- Some things are generally best in side channels:
- Anything explicitly banned in #dreamwidth (politics, religion)
- Extended off-topic chatter (particularly when it's just two participants), although 'topic' is sometimes hazy
- Blatantly sexual content
- Things that seem to be bothering other people
- Any topic that an op has asked to be moved
- #dreamwidth is not intended to be a Safe For Work zone, but it also should avoid the extended sort of "locker room" discussion that can be so off-putting as a first exposure to a FLOSS project. It's a delicate balance and ops appreciate all efforts to keep it from tipping too far.
- The definition of "Not Safe For Work" varies from person to person, but if you think any given link is NSFW, it is worth advising at the time you link.
- Spoilers, particularly for currently-airing or recently released media, should be avoided in main channel, particularly given differing release dates in different countries.
- When using short-URL services (tinyurl, bit.ly, and the like) that obscure the original URL being linked to, it's appreciated to describe what you're linking to, particularly if it's to something of questionable appropriateness or a known timesink such as TVTropes.
- Misogyny, ableism, racism, nationalist insults, and the like are not appreciated, even in jest.
- a clarification on religion: [21:02] <rahaeli> (also, I feel i should mention: religion is one of the Banned Topics in #dreamwidth, but the ban is on debating religious beliefs, not discussing religious-texts-as-literature or talking about theology from an academic standpoint; still, if anyone is uncomfortable about the topic PM me and I will ring the gong on the topic)
- It is not appropriate to tell anybody else to "RTFM" (Read the Fucking Manual) and similar forms of condescending advice (included but not limited to lmgtfy.com and its ilk). In general, asking about someone's understanding of the topic and the resources they've tried, to better understand their starting point, is appropriate. Assuming that they have not already put in some basic research, because they are asking a question that seems obvious to you, is not appropriate. No one is under any obligation to assist in answering questions they do not feel like answering for any reason, but channel culture encourages a spirit of curiosity and shared knowledge.
- Respect people's boundaries. Especially respect explicitly stated boundaries, but be on the lookout for less direct communication. Individual differences in communication style, sensitivity to the emotions of others, and other factors always have the potential for miscommunication and general badness; while this cannot always be removed, it can be reduced.
- If you are uncomfortable with the way another party is interacting with you, you are encouraged to speak up, either directly or to a member of the moderation team. Please bear in mind that some people are less sensitive to indirect communication than others.
- If a person who you are interacting with shows discomfort from the interaction, you are encouraged to proactively check whether your approach is okay, re-think your assumptions, or back off, even if they have not explicitly told you to stop or leave them alone. Please bear in mind that some people are less comfortable explicitly stating boundaries or saying no than others.
- Respect off-duty time. Sometimes a person who is on a specific team or affiliated with a specific external organization just wants to relax and socialize, not talk about work, or wants to vent about work rather than keep working off the clock.
On the lighter side: Book of Wholesome Hobbies
General IRC culture
The main channel strives to be a genial, welcoming place where people who are interested in Dreamwidth (in general, even if they don't feel called to volunteer at the moment) can spend time.
Since many of us are trying to make fewer possibly hurtful assumptions about other people on the internet, do not be surprised if someone asks what pronouns you prefer to be used when referring to you: singular or plural, masculine or feminine, neuter, or other other gender/gender-neutral pronouns. Sometimes people may make an educated guess, but if someone asks, it is most likely in the spirit of not making assumptions. It is always acceptable to decline to disclose information you do not feel like sharing.
Whoever's around on the hour is encouraged to announce a channel stretch break.
Channels
#dreamwidth
Open access. General Dreamwidth chatter, including owners, developers, support, and cheerleaders. Occasionally NSFW.
Chatter about Dreamwidth itself and questions about how the site works are almost always on topic. There is very little set topic, so general discussion is all right as well. Common topics include programming and design, fiber arts, food, accessibility, home improvement, pets, et cetera. Many of the regulars happen to have known each other for years, but don't be shy. Asking questions and interacting is great! Lurking is fine too.
For the bosses' peace of mind, discussion of politics and debates over the validity of another person's religion are to be kept to other channels.
#dreamwidth-antispam
Access restricted. For the anti-spam team. If you are a member of the team and need access to the channel (all current team members may request access), say something in dw_antispam and/or ping an op (asking in the comm may be slow; the op may be afk, and a ping could get lost in a client crash). Ops are Azz and skrshawk. SpamBot is the resident bot, owned by exor674.
SpamBot announces new spam and when the queue has been cleared. The command SpamBot: spam
makes SpamBot list the current contents of the queue.
When in channel, the best practice is to announce that you'll take care of the spam that you're headed for, to avoid collision as much as possible.
#dreamwidth-bitch
Open access but officially unofficial.
This channel combines several legacy channels from the old server: #dw_bitch (complaints), #dw_nsfw (not-safe-for-work links and topics), #dw_tmi (way too much personal information), and #dreamwidth-hell (hellbot-spam and further complaints) as well.
The channel is intended for things that aren't appropriate in #dreamwidth, such as extensive complaints, NSFW discussions, medical TMI, and general TMI; possibly even politics, too. Botspam (hellbot, bitspam, and reminderbot) is unregulated in this channel.
In practice there are also technical discussions that pop up here (even though they would be OK in main-channel), since this *is* a #dreamwidth- channel.
#dreamwidth-dev
Open access, intended for developers, other people actively working, and people quietly watching the work. A development/training/support/testing-focused channel without side-chatter.
This channel contains developers working on Dreamwidth's code. They can often give assistance and advice to other devs working on Dreamwidth, and can sometimes also offer assistance to people who are setting up their own installation of the Dreamwidth code.
#dreamwidth-docs
Open access, intended for documentation team. For discussing documentation. This may be obsolete and from the old server.
#dreamwidth-games
Open access. Officially unofficial, for funtimes including Zilch and Acrophobia.
#dreamwidth-ops
Access restricted. Owners, employees, contractors, and Nagios Alertsy the Annoying Wonder Bot.
#dreamwidth-support
Open access, intended for current, past, future, and questioning Support team. Intended as a resource for volunteers interested in helping with technical support of Dreamwidth users: to hang out, ask questions, and learn. Run by the Triumvirate of Domtheknight (Dom), Chemicallace (Chemla), and MissKat (Kat)
People needing help with their own installation of the Dreamwidth code should try #dreamwidth-dev.
People needing help with Dreamwidth's features may find that there are more people who will be happy to answer any questions in #dreamwidth.
Other
There are sometimes impromptu channels created for specific discussions that do not fit regular channels. (Freenode's policies seem to state that these should be in the ##dreamwidth- namespace? Or is it just ##?)
Bots
IRC bots are programs people can interact with in the IRC channel. They have their own usernames and different uses. sophie (Sophira) programmed and hosts many of the bots; most are custom-written. The bots generally only speak when spoken to (with a few exceptions).
Infobot has been fed the wiki links for most of the bots on the server. Infobot, help <bot>
will usually result in a quick link to that bot's documentation.
All bots present in official Dreamwidth channels must have permission from rahaeli and xb95. Generally it is preferred to add features to an existing bot rather than add a new bot. If there is a bot feature that you would like to have in an official Dreamwidth channel, ask the owners and Sophira.
Alertsy
A Nagios bot that pages Mark/ops when the site is down. Or up. An archive of its messages can be found at @dw_alerts on Twitter.
Not to be mistaken for historical mentions of _nagios_, who is usually D being Very Silly at Mark's expense.
Alertsy speaks without being spoken to.
Bugsy
Bugsy is a bot that notifies the channel when bugs are opened, closed, or receive patches (although the attachment-upload function of Bugsy broke with a recent Bugzilla upgrade and the bot hasn't been patched yet). It will also bring up more information about any bug that you link to or mention in channel.
- bug <x> said in channel, anywhere in the sentence, will result in Bugsy linking the bug in question. If Bugsy isn't in the channel, Figment will normally ask him for you, as long as Figment is also in the channel.
- @<x>
- when starting a line with this, it does something, mostly Bugsy telling you that it wasn't a valid command (if you say "@denise that was awesome", for example).
Fig-Bit
Fig-Bit has several different features, and will answer to "Figment" or "Fig" interchangeably, as well as "Infobot" or "info" and "Bit". The bot names are not case-sensitive.
Fig-Bit is present in #dreamwidth, #dreamwidth-bitch, and #dreamwidth-support.
Infobot
There is a DW-specific infobot in the channel named Fig-Bit. Address all infobot commands to "infobot", rather than to Fig-Bit. You can use "info," instead of "infobot," for any of these commands if you wish.
Public Infobot Commands
Some commands can be used in all public channels that Fig-Bit is in.
- infobot, <x>
- This asks Fig-Bit to recall a factoid that was previously remembered. You can use this in channel or in PM.
- Many useful factoids are stored in the infobot. If there's something that IRC should know, it may have been stored in the infobot.
- infobot, ?<x>
- This asks Fig-Bit to search for factoid names containing <x>.
- infobot, ??<x>
- This asks Fig-Bit to search for factoid names and values containing <x>. If you're doing a general search, this is probably what you want to use.
Private Infobot Commands
Some infobot commands can only be used in private message with the infobot, as programming the infobot can become spammy to the channel you are in. To reduce the potential for spammers messing with the infobot, your nickname must be registered and you must be authenticated to it in order to send private messages to Fig-Bit.
- infobot, <x> is <y>
- This is how you ask Fig-Bit to remember a factoid <x>. For example, you might say:
infobot, wiki is http://wiki.dwscoalition.org/notes/
- which would ask him to remember that the factoid "wiki" was the URL to Dreamwidth's development wiki. This command works only in PM. You can ask him to recall a factoid with the command below.
- infobot, no, <x> is <y>
- If Fig-Bit already knows a factoid when you try to ask him to remember one, he'll tell you that he already knows it and he won't remember the new definition. This command tells him to change the factoid to the new definition anyway. This command works only in PM.
- infobot, forget <x>
- This asks Fig-Bit to forget the factoid <x>. This command works only in PM.
Notable Infobot factoids
Infobot as help feature
Infobot has been fed links to the wiki entries on most bots. Saying Infobot, help <bot> will generally result in a link to the wiki entry on how to use that bot.
Other useful Infobot items
qdb jargon
Bit
Bit is the decision-bot part of Fig-Bit. Ask Bit a yes or no question, or ask Bit to pick between comma-separated options. Bit will choose! (If you're not sure what pronouns to use when referring to Bit, just ask Bit, and Bit will tell you. Bit may be gender-fluid, as the answers do sometimes change.) Bit sometimes accepts botsnacks, depending on whim (and perhaps hunger, but nobody really knows), and, if accepted, will share them with Fig.
- Bit, tally will make Bit give a tally of the yes and no answers since the last time Bit was rebooted.
As Bit has not been specifically programmed to favor working on bugs, support, or code reviews over other (more frivolous) pursuits, it is clear that Bit just naturally favors these things, being a bot.
A video clip of the 'Bit' from Tron.
Support-bot
Fig-Bit is also a Support-bot, and will link to any support request mentioned in channel, and can be used to show a report on the current status of the support board. For those who are familiar with the support-bot Anna (from LiveJournal Support), Fig-Bit functions like her.
Support-bot commands can be addressed to Figment or Fig.
- Figment, green
- This asks Fig-Bit to retrieve the stats on the support requests without approved answers.
- The "green" report is of the format:
- <Total> green (<number> unanswered, <number> SNH) :: (<priority>) <category total> in <category> (<unanswered>+<still needs help>)
- All public support categories are listed in this report.
- "Unanswered" is new requests that have not yet received an approved answer.
- SNH is "Still Needs Help": requests that are in need of an answer, but have already had at least one approved answer.
- Asterisks before a category name indicate that the category needs attention, based on the number of open requests. (Senior support and the botmistress decide on the thresholds of how many open requests in a category at one time is typical; this can be reset as things change.)
- request <x> or req <x> said in channel, anywhere in the sentence, will result in Fig-Bit linking the support request in question and giving a basic summary of the request. In #dreamwidth-support only, typing #<x> (that is, the support request number preceded by a hash) will do the same thing, which may be quicker to type.
- Pasting a link to a Support request is like the above, but will only give the basic summary, with no link.
- Figment, tags
- This asks Fig-Bit to retrieve the bracketed tags in the subjects of support requests.
- Figment, stars
- This asks Fig-Bit to retrieve a list of categories that have reached their defined thresholds.
- Figment, be Goat
- Fig-Bit will give the green count in Goat style. (Goat was the LiveJournal Support support-bot before Anna.)
- Figment, points <x>
- Fig-Bit will give the number of support points for the given user or category, or (if not user or category is given) the total number of points available on the board if one were to leave an approved answer for all the open questions right now.
- Figment, stale
- Fig-Bit will give stats on the requests that have been open longest.
- Figment, recent
- Gives a detailed report of open support requests in multiple categories.
- Figment, recenttags
- Lists tags of current green requests.
- Figment, kittens
- Fig-Bit will give a list of the categories that are under their defined thresholds. (Categories = cats = small cats = kittens)
- Figment, random
- Fig-Bit will give a random support request, optionally within a given category.
- Figment, search
- Searches the summaries of green support requests for whatever you give it. This does not search the body of the request for performance reasons. Up to 5 results will be given in PM.
- Figment, stats
- Like the search command, but only displays a summary of the number of results found, without linking to the requests. Unlike search, the output for this command is not restricted to PM, and is allowed to appear in channel.
Reminderbot
This function is only available in PM and #dreamwidth-bitch.
Syntax:
- Remind me in
- Remind me at <time> <zone> <thing>
Example:
- Remind me in 12 minutes DING COOKIES ARE DONE
- Remind me at 5pm PDT PREPARE FOR AN EVENING OF AWESOME
This command does not need to be addressed directly to the bot.
The reminderbot uses time formats as seen in http://search.cpan.org/~muir/Time-modules-2011.0517/lib/Time/ParseDate.pm - lettered time zones are case-sensitive and must be uppercase.
When specifying a time for the bot to remind you, the bot will probably use today or tomorrow (if that time has already passed today) in the bot's time zone. If you are in a different time zone than the bot, you might want to specify the date some of the time.
Others
These may be addressed to "Fig" as well.
- Figment, countdown <time> <timezone>
- Gives the time remaining until the specified time. fig, countdown 9pm EDT
- Figment, gmt
- Displays the current Greenwich Meridian Time.
- Figment, utc
- Same as above
- Figment, is DW up?
- Asks Figment to check if DW is up. "up" can be replaced with "down" synonymously. Figment also remembers how to check LJ.
- Figment, math
- A basic calculator.
- Figment, latest <x>
- Reports the last entry posted by a Dreamwidth user. There is no default for this command; a username must be given.
- Figment, twitter <x>
- Reports the last tweet posted by a Twitter user. Defaults to @dreamwidth if no username is given. (The twitter account for Alertsy is @dw_alerts.)
- Figment, botsnack
- Not really its own command, but a nice way to reward our very useful bot.
RWhEll bot
You can feed items to Random Word hEll. When an item is fed to hell, hell will most likely spew out random items it has consumed. RWHell is present in #dreamwidth, #dreamwidth-bitch.
- feed <x> to hell
- /me feeds <x> to hell
- This feeds an item to Hell. Hell will probably at this point in time spew out one or two items it has been holding. It may also burp and not expel anything new.
- (Hell recognises a number of synonyms for "feed". The current list is "feed", "send", "damn", "punt", "toss", "smite", "condemn", "hurl", "throw", "kick", "cast", "banish", "drag", "pull", "consign", "push", "shove" and "drop". These can also be used in their equivalent form as part of a /me - for example, "/me damns <x> to hell".) For all of those verbs, the suffix "into hell" is understood as much as "to hell" is. "Darn <x> to heck" also works.
- hell, tally
- This tells you how many items hell is currently holding.
RWHell does not have a search function, so the only way to know what is in hell at any given time is to have kept track (or ask hell's minder).
There is a separate level of hell for every channel that RWhell is in, so objects that are fed to it in its testing channel will not re-emerge in #dreamwidth, and vice versa.
Hell is rate limited in #dreamwidth, to avoid abuse. Hell is not rate limited in #dreamwidth-bitch.
The rumor that hell is sentient is just that: a rumor. Really. We swear. ...We hope.
More on its history in Common Jargon and Random Word Hell.
Delegate IRC Commands
There are some commands that are used only by delegates - normally project leaders. These can be found on the IRC Advanced page.