instructions for generating local previews from a git repo

[wiki.git] / office / zephyrClasses.mdwn

diff --git a/office/zephyrClasses.mdwn b/office/zephyrClasses.mdwn
index 58d248c3839af6cf8a9489bcf1fc5ded56eafb11..8ef031a17036a5149d4cf0383d6cfe75e9c8531e 100644 (file)
--- a/office/zephyrClasses.mdwn
+++ b/office/zephyrClasses.mdwn
@@ -10,17 +10,48 @@ encouraged to just listen to the class at first and get a feel for the
 class's typical modes of behavior.  If you jump right in, you might
 risk accidentally offending someone.
 
-* **<sipb,\*,\*>** - The general class for SIPB members and prospectives. General discussion.
+* **<sipb,\*,\*>** — The archetypal zephyr class for SIPB
+members and prospectives. Features general discussion about the SIPB,
+from brainstorming about projects to random bits of humor.  It's
+considered polite to always use an instance when sending to **-c
+sipb**. *High traffic.*
 
-* **<sipb-door,\*,\*gt;** - Receives a zephyr whenever SIPB's office door opens or closes.  Great way to keep track of whether the office is open or not.
+* **<sipb-door,\*,\*>** — Receives a zephyr whenever SIPB's office door opens or closes.  Great way to keep track of whether the [[office]] is open or not.
 
-* **lt;sipb-auto,\*,\*>** - Receives a variety of automatically generated zephyrs, including...
-** *lt;sipb-auto,sipbmp3,\*>** 
-** *lt;sipb-auto,sipb-door,\*>** - See **<sipb-door,\*,\*gt;** above
-** *lt;sipb-auto,sipb-www,\*>**
-** *lt;sipb-auto,backups,\*>**
-** *lt;sipb-auto,nagios.stuff.HTTP,\*&gt**
+* **<sipb-auto,\*,\*>** — *High traffic.* Receives a variety of automatically generated zephyrs, including...
+  * **<sipb-auto,sipbmp3,\*>**  — Activity on [sipbmp3](http://http://sipb.mit.edu/sipbmp3/). *Usually high traffic.*
+  * **<sipb-auto,sipb-door,\*>** — See **<sipb-door,\*,\*>** above.
+  * **<sipb-auto,sipb-www,\*>** — Commit logs when changes are pushed to this website.
+  * **<sipb-auto,backups,\*>** — Log messages from automated backups of the SIPB AFS cell.
+  * **<sipb-auto,nagios.stuff.HTTP,\*>** — Alerts when SIPB's [stuff.mit.edu](http://stuff.mit.edu) server goes down.
 
+## Classes for SIPB Projects
 
+In general, you should only sub to these classes *if and only if*
+you're interested in helping with a specific project.
 
+* **<scripts,\*,\*>** — If you're interested in getting involved
+with [Scripts](http://scripts.mit.edu/), subscribe here to see what
+the Scripts team does behind the scenes. *High traffic.*
 
+* **<barnowl,\*,\*>** — Discussion of [Barnowl](http://barnowl.mit.edu/), a zephyr client written and maintained by SIPB members.
+
+* **<debathena,\*,\*>** — Discussion of [Debathena](http://debathena.mit.edu/), a project designed to bring the functionality of Athena to your Debian or Ubuntu system. Debathena is also the basis of the next official version of Athena. *High traffic.*
+
+* **<dodona-discuss,\*,\*>** — Discussing the development and coding of [Dodona](http://dodona.scripts.mit.edu), a SIPB zephyrbot.
+   * **<dodona,\*,\*>** — The "official" class for Dodona to run and give advice on. Currently *low traffic*, as Dodona rarely runs. 
+   * **<dodona-test,\*,\*>** — Class for trial runs of Dodona. *High traffic*.
+
+* **<clockworks,\*,\*>** — Discussion of [[clockworks|projects/clockworks]].
+
+## Other Useful Classes
+
+These are not actually SIPB-related classes, although many people
+affiliated with SIPB and/or IS&T listen to them.  You should not send
+zephyrs to any of these classes unless you have a good reason.
+
+* **<consult,\*,\*>** - 
+
+* **<filsrv,\*,\*>** — Announcements of filesystem outages
+
+* **<3down,\*,\*>** — Recieves zephyrs about MIT service status (see also [3down website](http://3down.mit.edu/))